rpcSmSetThreadHandle 函式 (rpcndr.h)

  • 發行項

RpcSmSetThreadHandle 函式會設定存根記憶體管理環境的線程句柄。

語法

RPC_STATUS RpcSmSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

參數

Id

呼叫 RpcSmGetThreadHandle 所傳回的線程句柄。

傳回值

值 意義
RPC_S_OK
 呼叫成功。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

備註

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

呼叫 RpcSmAllocate 和 RpcSmFree 的多個線程必須使用相同的記憶體管理線程句柄，才能管理相同的記憶體。 在繁衍新的線程來管理相同的記憶體之前，建立記憶體管理環境的線程 (父線程) 呼叫 RpcSmGetThreadHandle 來取得此環境的線程句柄。 然後，繁衍的線程會使用父線程所提供的新管理員句柄呼叫 RpcSmSetThreadHandle 。

請注意， RpcSmSetThreadHandle 通常是由伺服器管理員程序繁衍的線程所呼叫。 存根會設定管理員程式的記憶體管理環境，而管理員會呼叫 RpcSmGetThreadHandle 以取得線程句柄。 然後，每個繁衍的線程都會呼叫 RpcSmGetThreadHandle ，以存取管理員的記憶體管理環境。

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

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 rpcndr.h (包含 Rpc.h)
程式庫 Rpcrt4.lib
Dll Rpcrt4.dll

另請參閱

RpcSmAllocate

RpcSmFree

RpcSmGetThreadHandle