IProcessInitializer Interface

Definição

Namespace:

System.EnterpriseServices

Assembly:

System.EnterpriseServices.dll

Dá suporte a métodos que podem ser chamados quando um componente COM é inicializado ou desligado.

public interface class IProcessInitializer

[System.Runtime.InteropServices.Guid("1113f52d-dc7f-4943-aed6-88d04027e32a")]
[System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)]
public interface IProcessInitializer

[<System.Runtime.InteropServices.Guid("1113f52d-dc7f-4943-aed6-88d04027e32a")>]
[<System.Runtime.InteropServices.InterfaceType(System.Runtime.InteropServices.ComInterfaceType.InterfaceIsIUnknown)>]
type IProcessInitializer = interface

Public Interface IProcessInitializer

Derivado

System.ServiceModel.ComIntegration.DllHostInitializer

Atributos

GuidAttribute InterfaceTypeAttribute

Comentários

Implemente os IProcessInitializer métodos de interface em componentes atendidos se desejar executar a inicialização ou o código de desligamento quando um processo de servidor (Dllhost.exe) for iniciado ou desligado, respectivamente.

O COM+ fornece Startup eventos e Shutdown quando Dllhost.exe inicia e termina. Esse recurso permite que todos os componentes COM+ instalados em um aplicativo de servidor COM+ (conhecido como componentes do servidor posteriormente) executem a inicialização personalizada e limpo código. Uma instância de cada componente que implementa a IProcessInitializer interface será criada e armazenada durante o processo. Quando implementado em um ServicedComponent, o InitializesServerApplication parâmetro na COMAdminCatalogObject coleção Components precisa ser definido true como durante o registro do componente, para que os métodos de interface sejam chamados durante a inicialização e o desligamento.

Usando os Startup eventos e Shutdown , você pode inicializar recursos, criar conexões, inicializar dados compartilhados e executar código de limpeza. No entanto, você não deve acessar estados específicos do COM+ porque as instâncias dos componentes do servidor ainda não foram criadas. Além disso, o código nos eventos e Shutdown deve retornar o Startup mais rápido possível, pois o sistema aguarda apenas 90 segundos para Dllhost.exe se preparar para aceitar ativações depois que o sistema iniciar o processo. Se Dllhost.exe não sinalizar que está pronto dentro de 90 segundos, o sistema encerrará o processo; Portanto, todo o processamento de inicialização precisa ser concluído dentro desse período. Cada componente do servidor que participa da inicialização deve dar suporte à IProcessInitializer interface . Em DllHost.exe inicialização, o COM+ cria todos os componentes do servidor que solicitaram esse serviço, chama QueryInterface a IProcessInitializer interface e chama a Startup função. Da mesma forma, quando o processo de DllHost.exe é desligado, ele chama a Shutdown função nesses ponteiros de interface armazenados anteriormente.

Métodos

Shutdown()	Executa ações de desligamento. Chamado quando o Dllhost.exe é desligado.
Startup(Object)	Executa a inicialização no startup. Chamado quando Dllhost.exe é iniciado.