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 來儲存和還原其記憶體管理環境。
注意RpcSsSetThreadHandle 例程會引發例外狀況，而 RpcSmSetThreadHandle 例程會傳回錯誤碼。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | rpcndr.h (包含 Rpc.h) |
| 程式庫 | Rpcrt4.lib |
| Dll | Rpcrt4.dll |