RpcSsDontSerializeContext

The RpcSsDontSerializeContext function disables run-time serialization of multiple calls dispatched to server-manager routines on the same context handle. Use of this function is not recommended. Developers should use mixed mode–content handle serialization instead. The See Also section provides links to more appropriate functions.

void RPC_ENTRY RpcSsDontSerializeContext(void);

Parameters

This function has no parameters.

Return Value

This function does not return a value.

Remarks

The RpcSsDontSerializeContext function prevents the run time 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 run down occurs, your context run-down routine will not run until all outstanding client requests have completed. Changes to the context handle state, including freeing the context handle typically, must continue to be serialized.

It is recommended that, if your distributed application invokes the RpcSsDontSerializeContext function, the call should be made before the server program begins handling remote procedure calls.

Note  Typically, the RPC run-time 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 against the context running down while a call is dispatched.

Note  After it is called, the RpcSsDontSerializeContext function is not revertible for the life of the process.

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 Rpcndr.h; include Rpc.h.
Library	Use Rpcrt4.lib.
DLL	Requires Rpcrt4.dll.

See Also

context_handle_serialize
context_handle_noserialize
RpcSsContextLockShared
RpcSsContextLockExclusive
Server Context Run-down Routine
Multithreaded Clients and Context Handles