Compartilhar via

Função RpcSsSetThreadHandle (rpcndr.h)

  • Artigo

A função RpcSsSetThreadHandle define um identificador de thread para o ambiente de gerenciamento de memória stub.

Sintaxe

void RpcSsSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Parâmetros

Id

Identificador de thread retornado por uma chamada para RpcSsGetThreadHandle.

Retornar valor

Nenhum

Comentários

Um aplicativo chama RpcSsSetThreadHandle para definir um identificador de thread para o ambiente de gerenciamento de memória stub. Um thread usado para gerenciar a memória para o ambiente de gerenciamento de memória stub chama RpcSsGetThreadHandle para obter um identificador para seu ambiente de memória. Dessa forma, outro thread que chama RpcSsSetThreadHandle usando esse identificador pode usar o mesmo ambiente de gerenciamento de memória.

O mesmo identificador de thread deve ser usado por vários threads que chamam RpcSsAllocate e RpcSsFree para gerenciar a mesma memória. Antes de gerar novos threads para gerenciar a mesma memória, o thread que estabeleceu o ambiente de gerenciamento de memória (thread pai) chama RpcSsGetThreadHandle para obter um identificador de thread para esse ambiente. Em seguida, os threads gerados chamam RpcSsSetThreadHandle com o identificador fornecido pelo thread pai.

Normalmente, um thread gerado por um procedimento gerenciador de servidor chama RpcSsSetThreadHandle. O stub configura o ambiente de gerenciamento de memória para o procedimento de gerente e o gerente chama RpcSsGetThreadHandle para obter um identificador de thread. Em seguida, cada thread gerado chama RpcSsGetThreadHandle para obter acesso ao ambiente de gerenciamento de memória do gerenciador.

Um thread também pode chamar RpcSsGetThreadHandle e RpcSsSetThreadHandle para salvar e restaurar seu ambiente de gerenciamento de memória.

Nota A rotina RpcSsSetThreadHandle gera exceções, enquanto a rotina RpcSmSetThreadHandle retorna o código de erro.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho rpcndr.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcSmSetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsGetThreadHandle