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)
Library Rpcrt4.lib
DLL Rpcrt4.dll

另请参阅

RpcSmSetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsGetThreadHandle