3.1.4.45 RCloseNotifyHandle (Opnum 49)

  • Article

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.