Freigeben über


ICLRRuntimeHost::ExecuteInAppDomain-Methode

Gibt die AppDomain an, in der der angegebene verwaltete Code ausgeführt werden soll.

Syntax

HRESULT ExecuteInAppDomain(  
    [in] DWORD AppDomainId,
    [in] FExecuteInDomainCallback pCallback,
    [in] void* cookie  
);  

Parameter

AppDomainId
[in] Die numerische ID der AppDomain, in der die angegebene Methode ausgeführt werden soll.

pCallback
[in] Ein Zeiger auf die Funktion, die innerhalb der angegebenen AppDomain ausgeführt werden soll.

cookie
[in] Ein Zeiger auf undurchsichtigen, vom Anrufer zugewiesenen Arbeitsspeicher. Dieser Parameter wird von der Common Language Runtime (CLR) an den Domänenrückruf übergeben. Es handelt sich nicht um einen von der Laufzeitumgebung verwalteten Heapspeicher. Sowohl die Zuordnung als auch die Lebensdauer dieses Arbeitsspeichers werden vom Aufrufer gesteuert.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK ExecuteInAppDomain wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE Die 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

ExecuteInAppDomain ermöglicht dem Host die Steuerung, in welcher verwalteten AppDomain die verwaltete Methode ausgeführt werden soll. Sie können den Wert des Bezeichners einer Anwendungsdomäne abrufen, der dem Wert der Id-Eigenschaft entspricht, indem Sie die GetCurrentAppDomainId-Methode aufrufen.

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.

Siehe auch