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 |