Freigeben über


ICLRRuntimeHost::GetCLRControl-Methode

Aktualisiert: November 2007

Ruft einen Schnittstellenzeiger vom Typ ICLRControl 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, der Hosts das Konfigurieren zusätzlicher Aspekte der CLR ermöglicht.

Rückgabewert

HRESULT

Beschreibung

S_OK

GetCLRControl 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

Das Zeitlimit für den Aufruf wurde ü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.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.idl

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

ICLRControl

ICLRRuntimeHost

Weitere Ressourcen

Bereitstellen der Common Language Runtime