RpcSsGetThreadHandle 函式會傳回存根記憶體管理環境的執行緒控制碼。
語法
RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();
返回值
| 價值觀 | Meaning |
|---|---|
|
通話成功了。 |
便條 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
備註
應用程式會呼叫 RpcSsGetThreadHandle 來取得存根記憶體管理環境的執行緒控制碼。 用來管理存根記憶體管理環境記憶體的執行程會使用 RpcSsGetThreadHandle 來接收其記憶體環境的控制碼。 如此一來，另一個使用此句柄呼叫 RpcSsSetThreadHandle 的線程就可以使用相同的記憶體管理環境。
呼叫 RpcSsAllocate 和 RpcSsFree 的多個執行緒必須使用相同的執行緒控制碼來管理相同的記憶體。 在產生新的執行緒來管理相同的記憶體之前，建立記憶體管理環境的執行緒 （父執行緒） 會呼叫 RpcSsGetThreadHandle 來取得此環境的執行緒控制碼。 然後，產生的執行緒會使用父執行緒所提供的控制碼呼叫 RpcSsSetThreadHandle 。
一般而言，伺服器管理員程式會在產生其他執行緒之前呼叫 RpcSsGetThreadHandle 。 存根會設定管理員程式的記憶體管理環境，而管理員會呼叫 RpcSsGetThreadHandle ，讓其他執行緒可以使用此環境。
執行程也可以呼叫 RpcSsGetThreadHandle 和 RpcSsSetThreadHandle 來儲存和還原其記憶體管理環境。
注意RpcSsGetThreadHandle 會引發例外狀況，而 RpcSmGetThreadHandle 會傳回錯誤碼。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| Header | rpcndr.h（包括 Rpc.h） |
| Library | rpcrt4.lib |
| DLL | Rpcrt4.dll |