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.

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

Confira também

RpcBindingReset

RpcSmDestroyClientContext