Función CoLeaveServiceDomain (comsvcs.h)

  • Artículo

Se usa para dejar el código que usa servicios COM+.

Sintaxis

void CoLeaveServiceDomain(
  [in] IUnknown *pUnkStatus
);

Parámetros

[in] pUnkStatus

Si desea conocer el estado de la transacción completada por la llamada, debe ser un puntero a la interfaz IUnknown de un objeto que implementa la interfaz ITransactionStatus . Si el código incluido no usó transacciones o si no necesita conocer el estado de la transacción, este parámetro debe ser NULL. Este parámetro se omite si no es NULL y si no se usó ninguna transacción en el dominio de servicio.

Valor devuelto

None

Observaciones

El código que se incluye entre las llamadas a CoEnterServiceDomain y CoLeaveServiceDomain se ejecuta en su propio contexto y se comporta como si fuera un método al que se llama desde un objeto creado dentro del contexto.

CoLeaveServiceDomain desencadena el servidor y, a continuación, las directivas del lado cliente como si se devolva una llamada de método. A continuación, el contexto actual se extrae de la pila de contexto y el contexto que se estaba ejecutando cuando se llamó a CoEnterServiceDomain se convierte en el contexto actual.

Debido a su diseño eficaz y porque no hay ninguna serialización de subprocesos implicada, el uso de CoEnterServiceDomain y CoLeaveServiceDomain implica una sobrecarga significativamente reducida en comparación con una llamada de método equivalente.

CoEnterServiceDomain y CoLeaveServiceDomain son especialmente útiles en las aplicaciones, que pueden usar estas funciones para acceder a servicios COM+ sin necesidad de crear un componente para hacerlo.

Los pares CoEnterServiceDomain y CoLeaveServiceDomain se pueden anidar. Es el usuario el que debe asegurarse de que los pares de llamadas están equilibrados para que cada llamada a CoLeaveServiceDomain coincida con una llamada anterior a CoEnterServiceDomain.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado comsvcs.h
Library ComSvcs.lib
Archivo DLL ComSvcs.dll

Consulte también

Servicios COM+ sin componentes

CServiceConfig

CoCreateActivity

CoEnterServiceDomain