NAME

rpc_sm_set_thread_handle — Sets a thread handle for the stub memory management environment

Synopsis

void rpc_sm_set_thread_handle(
rpc_ss_thread_handle_t id,
unsigned32 ∗status);

Parameters

Input

idSpecifies a thread handle returned by a call to the routine rpc_sm_get_thread_handle(). 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

An application thread calls rpc_sm_set_thread_handle() to set a thread handle for memory management within the stub memory management environment.  A thread that is managing memory within the stub memory managment scheme calls rpc_sm_get_thread_handle() to get a thread handle for its current stub memory management environment.  A thread that calls rpc_sm_set_thread_handle() with this handle is able to use the same memory management environment. 

When multiple threads call rpc_sm_allocate() and rpc_sm_free() to manage the same memory, they must share the same thread handle.  The thread that established the stub memory management environment calls rpc_sm_get_thread_handle() to get a thread handle before spawning new threads that will manage the same memory.  The spawned threads then call rpc_sm_set_thread_handle() with the handle provided by the parent thread. 

Note:

Typically, rpc_sm_set_thread_handle() is called by a thread spawned by a server manager routine.  Normally the stub sets up the memory management environment for the manager routine and the manager calls rpc_sm_get_thread_handle() to get a thread handle.  Each spawned thread then calls rpc_sm_get_thread_handle() to get access to the manager’s memory management environment. 

A thread may also use rpc_sm_get_thread_handle() and rpc_sm_set_thread_handle() to save and restore its memory management environment. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

rpc_s_ok
Success.

Related Information

Functions: rpc_sm_allocate(3rpc), rpc_sm_free(3rpc), rpc_sm_get_thread_handle(3rpc).