Share via

RPCNOTIFICATION_ROUTINE

  • Article

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

Client Requires Windows Vista, Windows XP, Windows 2000 Professional, Windows NT Workstation, Windows Me, Windows 98, or Windows 95.
Server Requires Windows Server "Longhorn", Windows Server 2003, Windows 2000 Server, or Windows NT Server.
Header

Declared in Rpcdce.h; include Rpc.h.

See Also

Asynchronous RPC
RPC_ASYNC_STATE