RpcSsGetThreadHandle 関数 (rpcndr.h)

RpcSsGetThreadHandle 関数は、スタブ メモリ管理環境のスレッド ハンドルを返します。

構文

RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();

戻り値

値	意味
RPC_S_OK	呼び出しは成功しました。

 

メモ 有効なエラー コードの一覧については、「 RPC 戻り値」を参照してください。

 

注釈

アプリケーションは RpcSsGetThreadHandle を呼び出して、スタブ メモリ管理環境のスレッド ハンドルを取得します。 スタブ メモリ管理環境のメモリを管理するために使用されるスレッドは 、RpcSsGetThreadHandle を使用してそのメモリ環境のハンドルを受け取ります。 このようにして、このハンドルを使用して RpcSsSetThreadHandle を呼び出す別のスレッドは、同じメモリ管理環境を使用できます。

同じメモリを管理するには、 RpcSsAllocate と RpcSsFree を呼び出す複数のスレッドで同じスレッド ハンドルを使用する必要があります。 同じメモリを管理するために新しいスレッドを生成する前に、メモリ管理環境 (親スレッド) を確立したスレッドは RpcSsGetThreadHandle を呼び出して、この環境のスレッド ハンドルを取得します。 次に、生成されたスレッドは、親スレッドによって提供されるハンドルを使用して RpcSsSetThreadHandle を呼び出します。

通常、サーバー マネージャー プロシージャは、追加のスレッドが生成される前に RpcSsGetThreadHandle を呼び出します。 スタブはマネージャー プロシージャのメモリ管理環境を設定し、マネージャーは RpcSsGetThreadHandle を呼び出して、この環境を他のスレッドで使用できるようにします。

スレッドは 、RpcSsGetThreadHandle と RpcSsSetThreadHandle を呼び出して、メモリ管理環境を保存および復元することもできます。

メモRpcSsGetThreadHandle では例外が発生し、 RpcSmGetThreadHandle はエラー コードを返します。

 

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	rpcndr.h (Rpc.h を含む)
Library	Rpcrt4.lib
[DLL]	Rpcrt4.dll

こちらもご覧ください

RpcSmGetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsSetThreadHandle