IProcessInitializer Interface

Definição

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

Observações

Implemente os IProcessInitializer métodos de interface nos componentes servidos se quiser executar código de inicialização ou desligamento quando um processo servidor (Dllhost.exe) arranca ou desliga, respetivamente.

O COM+ fornece Startup eventos Shutdown quando Dllhost.exe começa e termina. Esta funcionalidade permite que quaisquer componentes COM+ instalados numa aplicação servidor COM+ (doravante denominados componentes de servidor) executem inicializações personalizadas e limpem código. Uma instância de cada componente que implementa a IProcessInitializer interface será criada e armazenada durante toda a duração do processo. Quando implementado num ServicedComponent, o InitializesServerApplication parâmetro COMAdminCatalogObject dentro da coleção de Componentes tem de ser definido para true durante o registo do componente, para que os métodos de interface sejam chamados durante o arranque e desligamento.

Usando os Startup eventos and Shutdown , podes inicializar recursos, criar ligações, inicializar dados partilhados e executar código de limpeza. No entanto, não deve aceder a 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 Startup eventos e Shutdown deve regressar o mais rapidamente possível, porque o sistema espera apenas 90 segundos para Dllhost.exe se preparar para aceitar ativações após o início do processo. Se Dllhost.exe não sinalizar que está pronto dentro de 90 segundos, o sistema termina o processo; assim, todo o processamento de inicialização deve ser concluído dentro deste prazo. Cada componente do servidor que participa na inicialização deve suportar a IProcessInitializer interface. No arranque DllHost.exe, o COM+ cria todos os componentes do servidor que solicitaram este serviço, chama QueryInterface a IProcessInitializer interface e chama a Startup função. De forma semelhante, quando o processo DllHost.exe é desligado, chama a Shutdown função nos ponteiros de interface previamente armazenados.