RPCNOTIFICATION_ROUTINE

The RPCNOTIFICATION_ROUTINE function provides programs that utilize asynchronous RPC with the ability to customize responses to asynchronous events.

void RPC_ENTRY RpcnotificationRoutine(
  struct _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

This function does not return a value.

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

See Also

Asynchronous RPC
RPC_ASYNC_STATE