IProcessInitializer Schnittstelle

Definition

Namespace:

System.EnterpriseServices

Assembly:

System.EnterpriseServices.dll

Unterstützt Methoden, die beim Starten oder Herunterfahren einer COM-Komponente aufgerufen werden können.

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

Abgeleitet

System.ServiceModel.ComIntegration.DllHostInitializer

Attribute

GuidAttribute InterfaceTypeAttribute

Hinweise

Implementieren Sie die IProcessInitializer Schnittstellenmethoden für serviced-Komponenten, wenn Sie Code zum Initialisieren oder Herunterfahren ausführen möchten, wenn ein Serverprozess (Dllhost.exe) gestartet bzw. heruntergefahren wird.

COM+ stellt Startup - und Shutdown -Ereignisse bereit, wenn Dllhost.exe beginnt und endet. Mit diesem Feature können alle COM+-Komponenten, die in einer COM+-Serveranwendung installiert sind (im Folgenden als Serverkomponenten bezeichnet), benutzerdefinierte Initialisierung ausführen und Code bereinigen. Eine Instanz jeder Komponente, die die -Schnittstelle implementiert, IProcessInitializer wird für die Dauer des Prozesses erstellt und gespeichert. Bei Implementierung in einem ServicedComponent muss der Parameter in der InitializesServerApplication COMAdminCatalogObject Components-Auflistung während der Registrierung der Komponente auf festgelegt true werden, damit die Schnittstellenmethoden beim Starten und Herunterfahren aufgerufen werden.

Mithilfe der Startup Ereignisse und können Sie Ressourcen Shutdown initialisieren, Verbindungen erstellen, freigegebene Daten initialisieren und Bereinigungscode ausführen. Sie dürfen jedoch nicht auf Zustände zugreifen, die spezifisch für COM+ sind, da noch keine Instanzen von Serverkomponenten erstellt wurden. Darüber hinaus sollte der Code in den Startup - und Shutdown -Ereignissen so schnell wie möglich zurückgegeben werden, da das System nur 90 Sekunden auf Dllhost.exe wartet, um die Annahme von Aktivierungen vorzubereiten, nachdem das System den Prozess gestartet hat. Wenn Dllhost.exe nicht signalisiert, dass er innerhalb von 90 Sekunden bereit ist, beendet das System den Prozess. daher muss die gesamte Initialisierungsverarbeitung innerhalb dieses Zeitraums abgeschlossen werden. Jede Serverkomponente, die an der Initialisierung teilnimmt, muss die IProcessInitializer -Schnittstelle unterstützen. Beim Start DllHost.exe erstellt COM+ alle Serverkomponenten, die diesen Dienst angefordert haben, ruft QueryInterface für die IProcessInitializer -Schnittstelle auf und ruft die Startup -Funktion auf. Wenn der DllHost.exe Prozess heruntergefahren wird, ruft er die Shutdown -Funktion für diese zuvor gespeicherten Schnittstellenzeiger auf.

Methoden

Shutdown()	Führt Aktionen zum Herunterfahren aus. Wird beim Herunterfahren von Dllhost.exe aufgerufen.
Startup(Object)	Führt die Initialisierung beim Systemstart durch. Wird beim Starten von Dllhost.exe aufgerufen.