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 é 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 = interfacePublic Interface IProcessInitializer- Derivado
- Atributos
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. |
