Função RpcSsGetThreadHandle (rpcndr.h)

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

Sintaxe

RPC_SS_THREAD_HANDLE RpcSsGetThreadHandle();

Valor retornado

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.

 

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

 

Comentários

Um aplicativo chama RpcSsGetThreadHandle para obter 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 usa RpcSsGetThreadHandle para receber 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 procedimento gerenciador de servidor chama RpcSsGetThreadHandle antes que threads adicionais sejam gerados. O stub configura o ambiente de gerenciamento de memória para o procedimento de gerente e o gerente chama RpcSsGetThreadHandle para disponibilizar esse ambiente para os outros threads.

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

ObservaçãoRpcSsGetThreadHandle gera exceções, enquanto RpcSmGetThreadHandle 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

RpcSmGetThreadHandle

RpcSsAllocate

RpcSsFree

RpcSsSetThreadHandle