Función CoLeaveServiceDomain (comsvcs.h)
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 |