Compartir a través de


Función RpcSmGetThreadHandle (rpcndr.h)

La función RpcSmGetThreadHandle devuelve un identificador de subproceso o NULL para el entorno de administración de memoria de código auxiliar.

Sintaxis

RPC_SS_THREAD_HANDLE RpcSmGetThreadHandle(
  RPC_STATUS *pStatus
);

Parámetros

pStatus

Puntero al estado devuelto.

Valor devuelto

Valor Significado
RPC_S_OK
La llamada se realizó correctamente.
 
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
 

Comentarios

Las aplicaciones llaman a RpcSmGetThreadHandle para obtener un identificador de subproceso para el entorno de administración de memoria de código auxiliar. Un subproceso usado para administrar la memoria para el entorno de administración de memoria de código auxiliar usa RpcSmGetThreadHandle para recibir un identificador para su entorno de memoria. De este modo, otro subproceso que llama a RpcSmSetThreadHandle mediante este identificador puede usar el mismo entorno de administración de memoria.

Varios subprocesos que llaman a RpcSmAllocate y RpcSmFree deben usar el mismo identificador de subprocesos de administración de memoria para administrar la misma memoria. Antes de generar nuevos subprocesos para administrar la misma memoria, el subproceso que estableció el entorno de administración de memoria (subproceso primario) llama a RpcSmGetThreadHandle para obtener un identificador de subproceso para este entorno. A continuación, los subprocesos generados llaman a RpcSmSetThreadHandle con el nuevo identificador de administrador proporcionado por el subproceso primario.

Normalmente, un procedimiento del administrador del servidor llama a RpcSmGetThreadHandle antes de que se generen subprocesos adicionales. El código auxiliar configura el entorno de administración de memoria para el procedimiento de administrador y el administrador llama a RpcSmGetThreadHandle para que este entorno esté disponible para los demás subprocesos.

Un subproceso también puede llamar a RpcSmGetThreadHandle y RpcSmSetThreadHandle para guardar y restaurar su entorno de administración de memoria.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado rpcndr.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RpcSmAllocate

RpcSmFree

RpcSmSetThreadHandle