ICLRRuntimeHost::GetCLRControl-Methode

Artikel
08/10/2011

Ruft einen Schnittstellenzeiger vom Typ ICLRControl-Schnittstelle ab, den Hosts zum Anpassen von Aspekten der Common Language Runtime (CLR) verwenden können.

HRESULT GetCLRControl(
    [out] ICLRControl** pCLRControl
);

Parameter

pCLRControl
[out] Ein Schnittstellenzeiger vom Typ ICLRControl-Schnittstelle, der Hosts das Konfigurieren zusätzlicher Aspekte der CLR ermöglicht.

Rückgabewert

HRESULT	Beschreibungen
S_OK	GetCLRControl 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. 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.
HOST_E_INVALIDOPERATION	Die CLR wurde bereits gestartet.

Hinweise

ICLRControl stellt die ICLRControl::GetCLRManager-Methode-Methode bereit, die dem Host das Abrufen eines Schnittstellenzeigers auf einen der "Manager"-Typen ermöglicht.