Freigeben über

IProcessInitializer-Schnittstelle

  • Artikel

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

Namespace: System.EnterpriseServices
Assembly: System.EnterpriseServices (in system.enterpriseservices.dll)

Syntax

'Declaration
<GuidAttribute("1113f52d-dc7f-4943-aed6-88d04027e32a")> _
<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)> _
Public Interface IProcessInitializer
'Usage
Dim instance As IProcessInitializer

[GuidAttribute("1113f52d-dc7f-4943-aed6-88d04027e32a")] 
[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)] 
public interface IProcessInitializer

[GuidAttribute(L"1113f52d-dc7f-4943-aed6-88d04027e32a")] 
[InterfaceTypeAttribute(ComInterfaceType::InterfaceIsIUnknown)] 
public interface class IProcessInitializer

/** @attribute GuidAttribute("1113f52d-dc7f-4943-aed6-88d04027e32a") */ 
/** @attribute InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown) */ 
public interface IProcessInitializer

GuidAttribute("1113f52d-dc7f-4943-aed6-88d04027e32a") 
InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown) 
public interface IProcessInitializer

Hinweise

Implementieren Sie die IProcessInitializer-Schnittstellenmethoden für Serviced Components, wenn beim Starten oder Herunterfahren eines Serverprozesses (Dllhost.exe) Code zum Initialisieren bzw. Herunterfahren ausgeführt werden soll.

COM+ stellt beim Starten und Beenden von Dllhost.exe das Startup-Ereignis und Shutdown-Ereignis bereit. Dieses Feature ermöglicht allen in einer COM+-Serveranwendung installierten COM+-Komponenten (im Folgenden als Serverkomponenten bezeichnet) die Ausführung von benutzerdefiniertem Code zum Initialisieren und Bereinigen. Es wird eine Instanz jeder Komponente, die die IProcessInitializer-Schnittstelle implementiert, erzeugt und für die Dauer des Prozesses gespeichert und beim Starten und Herunterfahren für die Schnittstellenmethoden aufgerufen. Wenn der InitializesServerApplication-Parameter im COMAdminCatalogObject in der Komponentenauflistung für eine ServicedComponent implementiert ist, wird er bei der Registrierung der Komponente auf true festgelegt.

Mit dem Startup-Ereignis und dem Shutdown-Ereignis können Sie Ressourcen initialisieren, Verbindungen erstellen, gemeinsam verwendete Daten initialisieren und Bereinigungscode ausführen. Allerdings darf nicht auf COM+-spezifische Zustände zugegriffen werden, weil noch keine Instanzen von Serverkomponenten erstellt wurden. Außerdem müssen das Startup-Ereignis und das Shutdown-Ereignis möglichst schnell ausgeführt werden, weil das System nach dem Starten des Prozesses nur 90 Sekunden wartet, dass Dllhost.exe die Übernahme von Aktivierungen vorbereitet. Wenn Dllhost.exe nicht innerhalb von 90 Sekunden Bereitschaft signalisiert, beendet das System den Prozess. Daher muss die gesamte Initialisierungsverarbeitung innerhalb dieser Zeitspanne abgeschlossen sein. Jede an der Initialisierung beteiligte Serverkomponente muss die IProcessInitializer-Schnittstelle unterstützen. Beim Starten von DllHost.exe erstellt COM+ alle Serverkomponenten, die diesen Dienst angefordert haben, und ruft QueryInterface für die IProcessInitializer-Schnittstelle sowie die Startup-Funktion auf. Ebenso ruft COM+ nach dem Herunterfahren von DllHost.exe die Shutdown-Funktion für diese zuvor gespeicherten Schnittstellenzeiger auf.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1

Siehe auch

Referenz

IProcessInitializer-Member
System.EnterpriseServices-Namespace