Função CoLeaveServiceDomain (comsvcs.h)

Usado para deixar o código que usa serviços COM+.

Sintaxe

void CoLeaveServiceDomain(
  [in] IUnknown *pUnkStatus
);

Parâmetros

[in] pUnkStatus

Se você quiser saber o status da transação que é concluída pela chamada, isso deve ser um ponteiro para a interface IUnknown de um objeto que implementa a interface ITransactionStatus. Se o código delimitado não tiver usado transações ou se você não precisar saber a transação status, esse parâmetro deverá ser NULL. Esse parâmetro será ignorado se não for NULL e se nenhuma transação tiver sido usada no domínio de serviço.

Retornar valor

Nenhum

Comentários

O código entre chamadas para CoEnterServiceDomain e CoLeaveServiceDomain é executado em seu próprio contexto e se comporta como se fosse um método chamado de um objeto criado dentro do contexto.

CoLeaveServiceDomain dispara o servidor e, em seguida, as políticas do lado do cliente como se uma chamada de método estivesse retornando. Em seguida, o contexto atual é exibido da pilha de contexto e o contexto que estava em execução quando CoEnterServiceDomain foi chamado se torna o contexto atual.

Devido ao seu design eficiente e porque nenhum marshaling de thread está envolvido, o uso de CoEnterServiceDomain e CoLeaveServiceDomain envolve uma sobrecarga significativamente reduzida em comparação com uma chamada de método equivalente.

CoEnterServiceDomain e CoLeaveServiceDomain são particularmente úteis em aplicativos, que podem usar essas funções para acessar serviços COM+ sem a necessidade de criar um componente para fazer isso.

Os pares CoEnterServiceDomain e CoLeaveServiceDomain podem ser aninhados. Cabe ao usuário garantir que os pares de chamadas sejam balanceados para que cada chamada para CoLeaveServiceDomain corresponda a uma chamada anterior para CoEnterServiceDomain.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	comsvcs.h
Biblioteca	ComSvcs.lib
DLL	ComSvcs.dll

Confira também

Serviços COM+ sem componentes

CServiceConfig

CoCreateActivity

CoEnterServiceDomain