IHostControl::SetAppDomainManager-Methode

Artikel
06/04/2023

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

Syntax

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` wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Timeout des Aufrufs.
HOST_E_NOT_OWNER	Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL	Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Bemerkungen

Der AppDomainManager stellt dem Host einen Mechanismus zur Verfügung, um einen Bootstrap in verwalteten Code durchzuführen und die Erstellung und die Einstellungen der einzelnen AppDomain zu steuern. Der AppDomainManager wird in jede AppDomain geladen, wenn die AppDomain erstellt wird. Wenn sie sich dafür entscheidet, benachrichtigt die CLR den Host, dass die Domäne der Anwendung erstellt wurde, indem sie den Wert des Parameters pUnkAppDomainManager festlegt.

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

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit 2.0 verfügbar.

Freigeben über