IProcessInitializer Interfejs

Definicja

Przestrzeń nazw:

System.EnterpriseServices

Zestaw:

System.EnterpriseServices.dll

Obsługuje metody, które mogą być wywoływane podczas uruchamiania lub zamykania składnika COM.

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

Pochodne

System.ServiceModel.ComIntegration.DllHostInitializer

Atrybuty

GuidAttribute InterfaceTypeAttribute

Uwagi

Zaimplementuj metody interfejsu IProcessInitializer w składnikach obsługiwanych, jeśli chcesz uruchomić kod inicjowania lub zamykania, gdy proces serwera (Dllhost.exe) zostanie uruchomiony lub zamknięty, odpowiednio.

Com+ udostępnia Startup zdarzenia i Shutdown po rozpoczęciu i zakończeniu Dllhost.exe. Ta funkcja umożliwia uruchamianie niestandardowej inicjowania i czyszczenia kodu wszystkich składników COM+ zainstalowanych w aplikacji serwera COM+ (nazywanej tutaj składnikami serwera). Wystąpienie każdego składnika, który implementuje IProcessInitializer interfejs, zostanie utworzone i przechowywane przez cały czas trwania procesu. Po zaimplementowaniu w elemencie ServicedComponentInitializesServerApplication parametr w COMAdminCatalogObject kolekcji Components musi być ustawiony na true podczas rejestracji składnika, aby metody interfejsu były wywoływane podczas uruchamiania i zamykania.

Za pomocą zdarzeń Startup i Shutdown można inicjować zasoby, tworzyć połączenia, inicjować udostępnione dane i uruchamiać kod oczyszczania. Nie można jednak uzyskać dostępu do stanów specyficznych dla modelu COM+, ponieważ wystąpienia składników serwera nie zostały jeszcze utworzone. Ponadto kod w zdarzeniach Startup i Shutdown powinien zostać zwrócony tak szybko, jak to możliwe, ponieważ system czeka tylko 90 sekund, aby Dllhost.exe przygotować się do akceptowania aktywacji po uruchomieniu procesu. Jeśli Dllhost.exe nie sygnalizuje gotowości w ciągu 90 sekund, system zakończy proces; w związku z tym wszystkie operacje inicjowania muszą zostać ukończone w tym przedziale czasu. Każdy składnik serwera, który uczestniczy w inicjowaniu, musi obsługiwać IProcessInitializer interfejs. Podczas uruchamiania DllHost.exe com+ tworzy wszystkie składniki serwera, które zażądały tej usługi, wywołuje QueryInterfaceIProcessInitializer interfejs i wywołuje Startup funkcję. Podobnie, gdy proces DllHost.exe zostanie zamknięty, wywołuje Shutdown funkcję dla tych wcześniej przechowywanych wskaźników interfejsu.

Metody

Shutdown()	Wykonuje akcje zamykania. Wywoływana po zamknięciu Dllhost.exe.
Startup(Object)	Wykonuje inicjowanie podczas uruchamiania. Wywoływana po uruchomieniu Dllhost.exe.