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
| 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 |