RpcSsSetThreadHandle
The RpcSsSetThreadHandle
function sets a thread handle for the stub memory management environment.
#include <rpc.h>
void RPC_ENTRY
RpcSsSetThreadHandle(
|
RPC_SM_THREAD_HANDLE Handle |
|
|
); |
|
Parameters
Handle
Specifies a
thread handle returned by a call to RpcSsGetThreadHandle.
Remarks
The RpcSsSetThreadHandle
routine is called by an application to set a thread handle for the stub memory
management environment. A thread used to manage memory for the stub memory
management environment calls RpcSsGetThreadHandle to obtain a handle for
its memory environment. In this way, another thread that calls RpcSsSetThreadHandle
by using this handle can then use the same memory management environment.
The same
thread handle must be used by multiple threads calling RpcSsAllocate and
RpcSsFree in order to manage the same memory. Before spawning new
threads to manage the same memory, the thread that established the memory
management environment (parent thread) calls RpcSsGetThreadHandle to
obtain a thread handle for this environment. Then, the spawned threads call RpcSsSetThreadHandle
with the handle provided by the parent thread.
The RpcSsSetThreadHandle
routine is usually called by a thread spawned by a server manager procedure.
The stub sets up the memory management environment for the manager procedure,
and the manager calls RpcSsGetThreadHandle to obtain a thread handle.
Then, each spawned thread calls RpcSsGetThreadHandle to get access to
the manager s memory management environment.
A thread can
also call RpcSsGetThreadHandle and RpcSsSetThreadHandle to save
and restore its memory management environment.
Note The RpcSsSetThreadHandle
routine raises exceptions, while the RpcSmSetThreadHandle routine
returns the error code.
See Also