rpcSmSetThreadHandle 函数 (rpcndr.h)
RpcSmSetThreadHandle 函数为存根内存管理环境设置线程句柄。
语法
RPC_STATUS RpcSmSetThreadHandle(
RPC_SS_THREAD_HANDLE Id
);
参数
Id
调用 RpcSmGetThreadHandle 返回的线程句柄。
返回值
| 值 | 含义 |
|---|---|
|
调用成功。 |
注意 有关有效错误代码的列表，请参阅 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) |
| Library | Rpcrt4.lib |
| DLL | Rpcrt4.dll |