Compartir a través de


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.

Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.
 

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

Consulte también

RpcBindingReset

RpcSmDestroyClientContext