ICLRRuntimeHost::GetCLRControl-Methode

Artikel
06/04/2023

Ruft einen Schnittstellenzeiger vom Typ ICLRControl Interface ab, den Hosts zur Anpassung von Aspekten der Common Language Runtime (CLR) verwenden können.

Syntax

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

Parameter

pCLRControl
[out] Ein Schnittstellenzeiger vom Typ ICLRControl Interface, der es Hosts ermöglicht, zusätzliche Aspekte der CLR zu konfigurieren.

Rückgabewert

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

Bemerkungen

ICLRControl stellt die GetCLRManager Method-Methode bereit, mit der der Host einen Schnittstellenzeiger auf einen der Managertypen erhalten kann.

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.

Freigeben über