RpcSsDontSerializeContext

The RpcSsDontSerializeContext function disables runtime serialization of multiple calls dispatched to server manager routines on the same context handle.

#include <rpc.h>
void RPC_ENTRY RpcSsDontSerializeContext(void); 

Remarks

Normally the RPC runtime serializes calls on the same context handle dispatched to server manager routines. Context handles are maintained on a per client basis and typically represent the server-side state. This means that your server manager does not have to guard against another thread from the same client changing the context or from the context running down while a call is dispatched.

The RpcSsDontSerializeContext function prevents RPC runtime from performing this serialization service, allowing multiple calls to be dispatched on a given context handle. Calling this function does not disable serialization entirely—when a context rundown occurs, your context rundown routine will not run until all outstanding client requests have completed. Changes to the context handle state, including freeing the context handle normally, must continue to be serialized.

Note  Once called, RpcSsDontSerializeContext is unrevertable for the life of the process.

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcndr.h.
  Import Library: Link with rpcrt4.lib.

See Also

Server Context Rundown Routine, Multi-threaded Clients and Context Handles