ICLRControl::GetCLRManager-Methode

Artikel
08/10/2011

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

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

Parameter

riid
[in] Die IID des Managertyps, der zurückgegeben werden soll. Die folgenden IID-Werte werden unterstützt.
- IID_ICLRDebugManager: Gibt an, dass ppObject den Typ ICLRDebugManager aufweisen wird.
- IID_ICLRErrorReportingManager: Gibt an, dass ppObject den Typ ICLRErrorReportingManager aufweisen wird.
- IID_ICLRGCManager: Gibt an, dass ppObject den Typ ICLRGCManager aufweisen wird.
- IID_ICLRHostProtectionManager: Gibt an, dass ppObject den Typ ICLRHostProtectionManager aufweisen wird.
- IID_ICLROnEventManager: Gibt an, dass ppObject den Typ ICLROnEventManager aufweisen wird.
- IID_ICLRPolicyManager: Gibt an, dass ppObject den Typ ICLRPolicyManager aufweisen wird.
- IID_ICLRTaskManager: Gibt an, dass ppObject den Typ ICLRTaskManager aufweisen wird.
ppObject
[out] Ein Schnittstellenzeiger auf den angeforderten Manager bzw. NULL, wenn ein ungültiger Managertyp angefordert wurde.

Rückgabewert

HRESULT	Beschreibungen
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 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. Nachdem eine Methode E_FAIL zurückgegeben hat, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_NOINTERFACE	Der Schnittstellentyp wird nicht unterstützt.