Compartilhar via

Função RpcSmDestroyClientContext (rpcndr.h)

  • Artigo

A função RpcSmDestroyClientContext recupera os recursos de memória do cliente para um identificador de contexto e torna o identificador de contexto NULL.

Sintaxe

RPC_STATUS RpcSmDestroyClientContext(
  void **ContextHandle
);

Parâmetros

ContextHandle

Identificador de contexto que não pode mais ser usado. O identificador é definido como NULL antes que RpcSMDestroyClientContext retorne.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_X_SS_CONTEXT_MISMATCH
 O manipulador é inválido.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Os aplicativos cliente usam RpcSmDestroyClientContext para recuperar recursos de um identificador de contexto inativo. Os aplicativos podem chamar RpcSmDestroyClientContext depois que um erro de comunicação torna o identificador de contexto inutilizável. A função RpcSmDestroyClientContext fornece a mesma funcionalidade que a função RpcSsDestroyClientContext .

Essa função não invoca o processo de execução do identificador de contexto do servidor.

Quando RpcSmDestroyClientContext recupera os recursos de memória, ele também torna o identificador de contexto NULL. Para obter mais informações, consulte Usando identificadores de contexto.

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

RpcSsDestroyClientContext