RPCNOTIFICATION_ROUTINE callback function (rpcasync.h)

Article
02/22/2024

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

Share via