Compartilhar via

Função RpcSmGetThreadHandle (rpcndr.h)

  • Artigo

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

Sintaxe

RPC_SS_THREAD_HANDLE RpcSmGetThreadHandle(
  RPC_STATUS *pStatus
);

Parâmetros

pStatus

Ponteiro para o status retornado.

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

Os aplicativos chamam RpcSmGetThreadHandle 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 RpcSmGetThreadHandle para receber 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.

Normalmente, um procedimento gerenciador de servidor chama RpcSmGetThreadHandle 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 RpcSmGetThreadHandle para disponibilizar esse ambiente para os outros threads.

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

RpcSmSetThreadHandle