3.1.4.45 RCloseNotifyHandle (Opnum 49)
The RCloseNotifyHandle method<77> unregisters the client from receiving future notifications via the RGetNotifyResults (section 3.1.4.44) method from the server for specified status changes on a specified service.
-
DWORD RCloseNotifyHandle( [in, out] LPSC_NOTIFY_RPC_HANDLE phNotify, [out] PBOOL pfApcFired );
phNotify: An SC_NOTIFY_RPC_HANDLE (section 2.2.6) data type that defines a handle to the notification status associated with the client. This is the handle returned by an RNotifyServiceStatusChange call.
pfApcFired: Not used.
Return Values: The method returns 0x00000000 (ERROR_SUCCESS) on success; otherwise, it returns the following error code.
-
Return value/code
Description
6
ERROR_INVALID_HANDLE
The handle is no longer valid.
In response to this request from the client, for a successful operation the server MUST close the handle specified in the phNotify parameter and stop notifying the client about status changes for the service record associated with the handle.