2.2.39 PCONTEXT_HANDLE

  • Article

msdn link

The PCONTEXT_HANDLE type keeps state information associated with a given client on a server. The state information is called the server's context. Clients can obtain a context handle to identify the server's context for their individual RPC sessions.

A context handle must be of the void * type, or a type that resolves to void *. The server program casts it to the required type.

The IDL attribute [context_handle], as specified in [C706], is used to declare PCONTEXT_HANDLE.

An interface that uses a context handle must have a binding handle for the initial binding, which has to take place before the server can return a context handle. The handle_t type is one of the predefined types of the interface definition language (IDL), which is used to create a binding handle.

 typedef [context_handle] void* PCONTEXT_HANDLE;
 typedef [ref] PCONTEXT_HANDLE* PPCONTEXT_HANDLE;