Compartilhar via


Função RpcSsDestroyClientContext (rpcndr.h)

A função RpcSsDestroyClientContext destrói um identificador de contexto que não é mais necessário para o cliente, sem entrar em contato com o servidor.

Sintaxe

void RpcSsDestroyClientContext(
  void **ContextHandle
);

Parâmetros

ContextHandle

Identificador de contexto a ser destruído. O identificador é definido como NULL antes que RpcSsDestroyClientContext retorne.

Retornar valor

RpcSsDestroyClientContext não tem valor retornado.

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

Comentários

RpcSsDestroyClientContext é usado pelo aplicativo cliente para recuperar os recursos de memória usados para manter um identificador de contexto no cliente. Essa função é usada quando ContextHandle não é mais válido, como quando ocorreu uma falha de comunicação e o servidor não está mais disponível. O identificador de contexto é definido como NULL. A função RpcSsDestroyClientContext fornece a mesma funcionalidade que a função RpcSmDestroyClientContext . Essa função não invoca o processo de execução do identificador de contexto do servidor.

Não use RpcSsDestroyClientContext para substituir uma função de servidor que fecha o identificador de contexto.

A função RpcSsDestroyClientContext poderá gerar uma exceção RPC_X_SS_CONTEXT_MISMATCH se o identificador de contexto passado para ele for inválido. Os aplicativos nunca devem passar um identificador de contexto inválido para essa função. Se uma exceção for gerada, ela indicará um erro no código de chamada e, portanto, deverá ser investigada e corrigida.

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

RpcBindingReset

RpcSmDestroyClientContext