IHostControl::SetAppDomainManager-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Benachrichtigt den Host, dass eine Anwendungsdomäne erstellt wurde.

HRESULT SetAppDomainManager (
    [in] DWORD     dwAppDomainID,
    [in] IUnknown* pUnkAppDomainManager
);

Parameter

dwAppDomainID
[in] Der numerische Bezeichner der ausgewählten AppDomain.
pUnkAppDomainManager
[in] Ein Zeiger auf das AppDomainManager-Objekt, das der Host als IUnknown implementiert.

Rückgabewert

HRESULT	Beschreibung
S_OK	SetAppDomainManager kehrte erfolgreich zurück.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Der AppDomainManager stellt dem Host einen Mechanismus bereit, um verwalteten Code über einen Bootstrap-Vorgang zu starten und Erstellung sowie Einstellungen jeder AppDomain zu steuern. Der AppDomainManager wird in jede AppDomain geladen, wenn diese AppDomain erstellt wird. Die CLR benachrichtigt den Host durch Festlegen des Werts des pUnkAppDomainManager-Parameters, dass die Anwendungsdomäne erstellt wurde.

In der Implementierung der SetAppDomainManager-Methode kann der Host den Assemblynamen und Typ für den Anwendungsdomänen-Manager festlegen.