220.127.116.11.143 ApiGetNotifyAsync (Opnum 147)
(Protocol Version 3) The ApiGetNotifyAsync method is an asynchronous RPC method that can be used instead of ApiGetNotify to instruct the server to return the next set of queued events corresponding to a particular context handle. The server MUST NOT complete this method until an indication has been queued to the port or the port has been closed through a separate call to the ApiUnblockGetNotifyCall or ApiCloseNotify method.
Servers SHOULD support this method.<113>
error_status_t ApiGetNotifyAsync( [in] HNOTIFY_RPC hNotify, [out, size_is(,*dwNumNotifications)] PNOTIFICATION_DATA_ASYNC_RPC* Notifications, [out] DWORD dwNumNotifications );
Notifications: A pointer to an array of one or more NOTIFICATION_DATA_ASYNC_RPC (section 18.104.22.168) structures corresponding to the next notification events that have been generated on the specified notification port, but have not yet been retrieved through previous calls to ApiGetNotifyAsync or ApiGetNotify.
dwNumNotifications: A pointer to a DWORD that contains the count of NOTIFICATION_DATA_ASYNC_RPC structures.
Return Values: This method MUST return one of the following values.
Return value/code Description
The method completed successfully.
The data that is pointed to by the hNotify parameter does not represent a valid HNOTIFY_RPC context handle.
The notification port represented by the hNotify parameter has been closed.
Either the ApiUnblockedGetNotificationCall (section 22.214.171.124.107) method or the ApiCloseNotify (section 126.96.36.199.57) method has been called in another thread. The client SHOULD terminate the notification thread.
For any other condition, the server MUST return a value that is not one of the values listed in the preceding table. The client MUST treat all such values identically, with the exception of errors specified in section 188.8.131.52, which are recoverable and for which the client SHOULD initiate the reconnect procedure.