Pointer to the current plug-in instance. Pointer to the URL of the request. Name of the target window or frame, or one of several special target names. For values, see NPN_GetURL. Plug-in-private value for associating the request with the subsequent NPP_URLNotify call, which passes this value (see Description below).
- If successful, the function returns NPERR_NO_ERROR.
- If unsuccessful, the plug-in is not loaded and the function returns an error code. For possible values, see Error Codes.
NPN_GetURLNotify works just like NPN_GetURL, with one exception. NPN_GetURLNotify notifies the plug-in instance upon successful or unsuccessful completion of the request by calling the plug-in's NPP_URLNotify function and passing it the notifyData value.
NPN_GetURLNotify typically handles the URL request asynchronously. It returns immediately and only later handles the request and calls NPP_URLNotify. This notification is the only way the plug-in can tell whether a request with a null target failed, or that a request with a non-null target completed.
- If the target is non-null, the browser calls NPP_URLNotify after it has finished loading the URL.
- If the target is null, the browser calls NPP_URLNotify after closing the stream by calling NPN_DestroyStream.
If this function is called with a target parameter value of _self or a parent to _self, this function should return an INVALID_PARAM NPError. This is the only way to notify the plug-in once it is deleted.