Función RpcSsDestroyClientContext (rpcndr.h)
La función RpcSsDestroyClientContext destruye un identificador de contexto que ya no necesita el cliente, sin ponerse en contacto con el servidor.
Sintaxis
void RpcSsDestroyClientContext(
void **ContextHandle
);
Parámetros
ContextHandle
Identificador de contexto que se va a destruir. El identificador se establece en NULL antes de que RpcSsDestroyClientContext devuelva.
Valor devuelto
RpcSsDestroyClientContext no tiene ningún valor devuelto.
Comentarios
La aplicación cliente usa RpcSsDestroyClientContext para reclamar los recursos de memoria usados para mantener un identificador de contexto en el cliente. Esta función se usa cuando ContextHandle ya no es válido, como cuando se ha producido un error de comunicación y el servidor ya no está disponible. El identificador de contexto se establece en NULL. La función RpcSsDestroyClientContext proporciona la misma funcionalidad que la función RpcSmDestroyClientContext . Esta función no invoca el proceso de ejecución del controlador de contexto del servidor.
No use RpcSsDestroyClientContext para reemplazar una función de servidor que cierre el identificador de contexto.
La función RpcSsDestroyClientContext puede producir una excepción de RPC_X_SS_CONTEXT_MISMATCH si el identificador de contexto pasado no es válido. Las aplicaciones nunca deben pasar un identificador de contexto no válido a esta función. Si se produce una excepción, indica un error en el código de llamada y, por tanto, debe investigarse y corregirse.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | rpcndr.h (incluya Rpc.h) |
Library | Rpcrt4.lib |
Archivo DLL | Rpcrt4.dll |