IProcessInitializer Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Dá suporte a métodos que podem ser chamados quando um componente COM é iniciado 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
- Atributos
Comentários
Implemente os IProcessInitializer métodos de interface em componentes atendidos se você quiser executar o código de inicialização ou desligamento quando um processo de servidor (Dllhost.exe) for iniciado ou desligado, respectivamente.
O COM+ fornece Startup e Shutdown eventos 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 limpem o 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 durante o registro do componente, para que os métodos de interface sejam chamados durante a inicialização e o desligamento.
Usando o e Startup os Shutdown eventos, você pode inicializar recursos, criar conexões, inicializar dados compartilhados e executar o código de limpeza. No entanto, você não deve acessar estados específicos do COM+ porque as instâncias de componentes do servidor ainda não foram criadas. Além disso, o código e os eventos devem retornar o StartupShutdown 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
| Nome | Description |
|---|---|
| Shutdown() |
Executa ações de desligamento. Chamado quando Dllhost.exe é desligado. |
| Startup(Object) |
Executa a inicialização na inicialização. Chamado quando Dllhost.exe é iniciado. |