Freigeben über


ICLRRuntimeHost::SetHostControl Method

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
);

Parameters

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

Return Value

HRESULT Description
S_OK SetHostControl erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE Die CLR wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem verwalteter Code nicht ausgeführt oder der Aufruf erfolgreich verarbeitet werden kann.
HOST_E_TIMEOUT Timeout des Anrufs.
HOST_E_NOT_OWNER Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine Faser darauf wartete.
E_FAIL Unbekannter katastrophaler Fehler. Wenn eine Methode E_FAIL zurückgibt, kann der 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.

Remarks

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

Requirements

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: In MSCorEE.dll als Ressource enthalten

.NET Framework-Versionen: seit 2.0 verfügbar

See also