Freigeben über

ICLRRuntimeHost::SetHostControl-Methode

  • Artikel

Legt den Schnittstellenzeiger fest, den die Common Language Runtime (CLR) verwenden kann, um die Implementierung der IHostControl-Schnittstelle des Hosts abzurufen

Syntax

HRESULT SetHostControl(  
    [in] IHostControl* pHostControl  
);

Parameter

pHostControl
[in] Ein Schnittstellenzeiger auf die Implementierung der IHostControl-Schnittstelle des Hosts

Rückgabewert

HRESULT BESCHREIBUNG
S_OK SetHostControl 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.
E_CLR_ALREADY_STARTED Die CLR wurde bereits initialisiert.

Bemerkungen

Sie müssen SetHostControl aufrufen, bevor die CLR initialisiert wird, d. h. bevor Sie die Startmethode aufrufen oder eine der Metadatenschnittstellen verwenden. Es wird empfohlen, SetHostControl unmittelbar nach dem Aufrufen der CorBindToCurrentRuntime-Funktion oder der corBindToRuntimeEx-Funktion aufzurufen.

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