RpcSmSetThreadHandle 函数 （rpcndr.h）

RpcSmSetThreadHandle 函数为存根内存管理环境设置线程句柄。

Syntax

RPC_STATUS RpcSmSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

参数

Id

调用 RpcSmGetThreadHandle 返回的线程句柄。

返回值

注解

应用程序调用 RpcSmSetThreadHandle 为存根内存管理环境设置线程句柄。 用于管理存根内存管理环境的内存的线程调用 RpcSmGetThreadHandle 以获取其内存环境的句柄。 这样，使用此句柄调用 RpcSmSetThreadHandle 的另一个线程就可以使用相同的内存管理环境。

调用 RpcSmAllocate 和 RpcSmFree 的多个线程必须使用同一内存管理线程句柄。 在生成新线程以管理同一内存之前，建立内存管理环境的线程（父线程）将调用 RpcSmGetThreadHandle 以获取此环境的线程句柄。 然后，生成的线程使用父线程提供的新管理器句柄调用 RpcSmSetThreadHandle 。

请注意， RpcSmSetThreadHandle 通常由由服务器管理器过程生成的线程调用。 存根为管理器过程设置内存管理环境，管理器调用 RpcSmGetThreadHandle 以获取线程句柄。 然后，每个生成线程都会调用 RpcSmGetThreadHandle 来访问管理器的内存管理环境。

线程还可以调用 RpcSmGetThreadHandle 和 RpcSmSetThreadHandle 来保存和还原其内存管理环境。

要求

另请参阅

RpcSmAllocate

RpcSmFree

RpcSmGetThreadHandle