Função RpcSsSetThreadHandle (rpcndr.h)
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.
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 |