RPCNOTIFICATION_ROUTINE callback function (rpcasync.h)
The RPCNOTIFICATION_ROUTINE function provides programs that utilize asynchronous RPC with the ability to customize responses to asynchronous events.
Syntax
RPCNOTIFICATION_ROUTINE RpcnotificationRoutine;
void RpcnotificationRoutine(
_RPC_ASYNC_STATE *pAsync,
void *Context,
RPC_ASYNC_EVENT Event
)
{...}
Parameters
pAsync
Pointer to a structure that contains the current state of the asynchronous RPC run-time library. For more information, see RPC_ASYNC_STATE.
Context
Reserved for future use. Windows 2000 currently sets this parameter to NULL.
Event
A value from the RPC_ASYNC_EVENT enumerated type that identifies the current asynchronous event.
Return value
None
Remarks
For each asynchronous remote procedure call that a client program executes, it can specify an asynchronous procedure call (APC). The RPC run-time library will invoke the APC when the asynchronous remote procedure call completes. The APC function must match the prototype specified by RPCNOTIFICATION_ROUTINE.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | rpcasync.h |