Freigeben über


IProcessInitializer Schnittstelle

Definition

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
Attribute

Hinweise

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

COM+ stellt - und Shutdown -Ereignisse bereitStartup, wenn Dllhost.exe gestartet und beendet wird. Dieses Feature ermöglicht es allen COM+-Komponenten, die in einer COM+-Serveranwendung (nachfolgend als Serverkomponenten bezeichnet) installiert sind, benutzerdefinierte Initialisierung auszuführen und Code zu sauber. Eine instance jeder Komponente, die die IProcessInitializer Schnittstelle implementiert, wird für die Dauer des Prozesses erstellt und gespeichert. Wenn er für implementiert ServicedComponentist, muss der InitializesServerApplication Parameter in der COMAdminCatalogObject Components-Auflistung während der Registrierung der Komponente auf true festgelegt werden, damit die Schnittstellenmethoden beim Starten und Herunterfahren aufgerufen werden.

Mithilfe der Startup Ereignisse und Shutdown können Sie Ressourcen initialisieren, Verbindungen erstellen, freigegebene Daten initialisieren und Bereinigungscode ausführen. Sie dürfen jedoch nicht auf Zustände zugreifen, die für COM+ spezifisch 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 wartet, bis Dllhost.exe nach Dem Starten des Prozesses auf die Annahme von Aktivierungen vorbereitet ist. Wenn Dllhost.exe nicht innerhalb von 90 Sekunden signalisiert, dass es bereit ist, beendet das System den Prozess. Daher muss die gesamte Initialisierungsverarbeitung innerhalb dieses Zeitrahmens abgeschlossen werden. Jede Serverkomponente, die an der Initialisierung beteiligt ist, muss die IProcessInitializer -Schnittstelle unterstützen. Bei DllHost.exe Start erstellt COM+ alle Serverkomponenten, die diesen Dienst angefordert haben, ruft QueryInterface die IProcessInitializer Schnittstelle auf und ruft die Startup Funktion auf. Ebenso wird beim Herunterfahren des DllHost.exe-Prozesses die Shutdown Funktion für die zuvor gespeicherten Schnittstellenzeiger aufgerufen.

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.

Gilt für: