Compartilhar via

Função RpcSmSetThreadHandle (rpcndr.h)

  • Artigo

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

Sintaxe

RPC_STATUS RpcSmSetThreadHandle(
  RPC_SS_THREAD_HANDLE Id
);

Parâmetros

Id

Identificador de thread retornado por uma chamada para RpcSmGetThreadHandle.

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 RpcSmSetThreadHandle para definir um identificador de thread para o ambiente de gerenciamento de memória de stub. Um thread usado para gerenciar a memória para o ambiente de gerenciamento de memória stub chama RpcSmGetThreadHandle para obter um identificador para seu ambiente de memória. Dessa forma, outro thread que chama RpcSmSetThreadHandle usando esse identificador pode usar o mesmo ambiente de gerenciamento de memória.

O mesmo identificador de thread de gerenciamento de memória deve ser usado por vários threads que chamam RpcSmAllocate e RpcSmFree 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 RpcSmGetThreadHandle para obter um identificador de thread para esse ambiente. Em seguida, os threads gerados chamam RpcSmSetThreadHandle com o novo identificador de gerenciador fornecido pelo thread pai.

Observe que RpcSmSetThreadHandle geralmente é chamado por um thread gerado por um procedimento server-manager. O stub configura o ambiente de gerenciamento de memória para o procedimento de gerente e o gerente chama RpcSmGetThreadHandle para obter um identificador de thread. Em seguida, cada thread gerado chama RpcSmGetThreadHandle para obter acesso ao ambiente de gerenciamento de memória do gerente.

Um thread também pode chamar RpcSmGetThreadHandle e RpcSmSetThreadHandle 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

Confira também

RpcSmAllocate

RpcSmFree

RpcSmGetThreadHandle