RpcSmSetThreadHandle 函式 （rpcndr.h）

RpcSmSetThreadHandle 函式會設定存根記憶體管理環境的執行緒控制碼。

語法

RPC_STATUS RpcSmSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

參數

Id

呼叫 RpcSmGetThreadHandle 所傳回的執行緒控制碼。

返回值

備註

應用程式會呼叫 RpcSmSetThreadHandle 來設定存根記憶體管理環境的執行緒控制碼。 用來管理存根記憶體管理環境記憶體的執行程會呼叫 RpcSmGetThreadHandle 來取得其記憶體環境的控制碼。 如此一來，另一個使用此句柄呼叫 RpcSmSetThreadHandle 的線程就可以使用相同的記憶體管理環境。

呼叫 RpcSmAllocate 和 RpcSmFree 的多個執行緒必須使用相同的記憶體管理執行緒控制碼，以管理相同的記憶體。 在產生新的執行程來管理相同的記憶體之前，建立記憶體管理環境的執行緒 （父執行緒） 會呼叫 RpcSmGetThreadHandle 來取得此環境的執行緒控制碼。 然後，產生的執行緒會呼叫 RpcSmSetThreadHandle ，並使用父執行緒所提供的新管理員控制碼。

請注意， RpcSmSetThreadHandle 通常是由伺服器管理員程式所產生的執行緒呼叫。 存根會設定管理員程式的記憶體管理環境，而管理員會呼叫 RpcSmGetThreadHandle 來取得執行緒控制碼。 然後，每個產生的執行緒都會呼叫 RpcSmGetThreadHandle 來存取管理員的記憶體管理環境。

執行緒也可以呼叫 RpcSmGetThreadHandle 和 RpcSmSetThreadHandle 來儲存和還原其記憶體管理環境。

需求

另請參閱

RpcSm分配

RpcSm免費

RpcSmGetThreadHandle