ICLRControl::GetCLRManager-Methode

Ruft einen Schnittstellenzeiger auf eine Instanz eines der Managertypen ab, die der Host zum Konfigurieren der Common Language Runtime (CLR) verwenden kann.

Syntax

HRESULT GetCLRManager (  
    [in]  REFIID  riid,  
    [out] void  **ppObject  
);  

Parameter

riid
[in] Die IID des zurückzugebenden Managertyps. Die folgenden IID-Werte werden unterstützt.

• IID_ICLRDebugManager: gibt an, dass ppObject den Typ ICLRDebugManager hat.

• IID_ICLRErrorReportingManager: gibt an, dass ppObject den Typ ICLRErrorReportingManager hat.

• IID_ICLRGCManager: gibt an, dass ppObject den Typ ICLRGCManager hat.

• IID_ICLRHostProtectionManager: gibt an, dass ppObject den Typ ICLRHostProtectionManager hat.

• IID_ICLROnEventManager: gibt an, dass ppObject den Typ ICLROnEventManager hat.

• IID_ICLRPolicyManager: gibt an, dass ppObject den Typ ICLRPolicyManager hat.

• IID_ICLRTaskManager: gibt an, dass ppObject den Typ ICLRTaskManager hat.

ppObject
[out] Ein Schnittstellenzeiger auf den angeforderten Manager oder NULL, wenn ein ungültiger Managertyp angefordert wurde.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die CLR wurde nicht in einen Prozess geladen oder 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.
E_NOINTERFACE	Der Schnittstellentyp wird nicht unterstützt.

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

• ICLRControl-Schnittstelle
• IHostControl-Schnittstelle