Función RpcSsSetThreadHandle (rpcndr.h)

Artículo
03/13/2024

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

Sintaxis

void RpcSsSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Parámetros

Id

Identificador de subproceso devuelto por una llamada a RpcSsGetThreadHandle.

Valor devuelto

None

Observaciones

Una aplicación llama a RpcSsSetThreadHandle para establecer un identificador de subproceso para el entorno de administración de memoria de código auxiliar. Un subproceso que se usa para administrar la memoria para el entorno de administración de memoria de código auxiliar llama a RpcSsGetThreadHandle para obtener 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 subproceso generado por un procedimiento de administrador del servidor llama a RpcSsSetThreadHandle. El código auxiliar configura el entorno de administración de memoria para el procedimiento de administrador y el administrador llama a RpcSsGetThreadHandle para obtener un identificador de subproceso. A continuación, cada subproceso generado llama a RpcSsGetThreadHandle para obtener acceso al entorno de administración de memoria del administrador.

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

Nota La rutina RpcSsSetThreadHandle genera excepciones, mientras que la rutina RpcSmSetThreadHandle devuelve el código de error.

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 (incluya Rpc.h)
Library	Rpcrt4.lib
Archivo DLL	Rpcrt4.dll

Consulte también