RpcSsSetThreadHandle 関数 (rpcndr.h)
RpcSsSetThreadHandle 関数は、スタブ メモリ管理環境のスレッド ハンドルを設定します。
構文
void RpcSsSetThreadHandle(
RPC_SS_THREAD_HANDLE Id
);
パラメーター
Id
RpcSsGetThreadHandle の呼び出しによって返されるスレッド ハンドル。
戻り値
なし
解説
アプリケーションは RpcSsSetThreadHandle を呼び出して、スタブ メモリ管理環境のスレッド ハンドルを設定します。 スタブ メモリ管理環境のメモリを管理するために使用されるスレッドは 、RpcSsGetThreadHandle を呼び出して、そのメモリ環境のハンドルを取得します。 このようにして、このハンドルを使用して RpcSsSetThreadHandle を呼び出す別のスレッドは、同じメモリ管理環境を使用できます。
同じメモリを管理するには、 RpcSsAllocate と RpcSsFree を呼び出す複数のスレッドで同じスレッド ハンドルを使用する必要があります。 同じメモリを管理するために新しいスレッドを生成する前に、メモリ管理環境 (親スレッド) を確立したスレッドは RpcSsGetThreadHandle を呼び出して、この環境のスレッド ハンドルを取得します。 次に、生成されたスレッドは、親スレッドによって提供されるハンドルを使用して RpcSsSetThreadHandle を呼び出します。
通常、サーバー マネージャー プロシージャによって生成されたスレッドは 、RpcSsSetThreadHandle を呼び出します。 スタブはマネージャー プロシージャのメモリ管理環境を設定し、マネージャーは RpcSsGetThreadHandle を呼び出してスレッド ハンドルを取得します。 その後、生成された各スレッドは RpcSsGetThreadHandle を呼び出して、マネージャーのメモリ管理環境にアクセスします。
スレッドは 、RpcSsGetThreadHandle と RpcSsSetThreadHandle を呼び出して、メモリ管理環境を保存および復元することもできます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | rpcndr.h (Rpc.h を含む) |
| Library | Rpcrt4.lib |
| [DLL] | Rpcrt4.dll |