Compartir a través de


Función RpcSsGetThreadHandle (rpcndr.h)

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

Syntax

RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();

Valor devuelto

Importancia Meaning
RPC_S_OK
La llamada se realizó correctamente.
 
Nota Para obtener una lista de códigos de error válidos, consulte Valores devueltos de RPC.
 

Observaciones

Una aplicación llama a RpcSsGetThreadHandle 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 auxiliar usa RpcSsGetThreadHandle para recibir un identificador para su entorno de memoria. De este modo, otro subproceso que llama a RpcSsSetThreadHandle mediante este identificador puede usar el mismo entorno de administración de memoria.

Varios subprocesos que llaman a RpcSsAllocate y RpcSsFree deben usar el mismo identificador de subprocesos 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 RpcSsGetThreadHandle para obtener un identificador de subproceso para este entorno. A continuación, los subprocesos generados llaman a RpcSsSetThreadHandle con el identificador proporcionado por el subproceso primario.

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

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

NotaRpcSsGetThreadHandle genera excepciones, mientras que RpcSmGetThreadHandle devuelve el código de error.
 

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
Header rpcndr.h (incluya Rpc.h)
Library Rpcrt4.lib
DLL de Rpcrt4.dll

Consulte también

RpcSmGetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsSetThreadHandle