ICLRRuntimeHost::SetHostControl-Methode

Legt den Schnittstellenzeiger fest, mit dem die Common Language Runtime (CLR) die Hostimplementierung von IHostControl-Schnittstelle abrufen kann.

HRESULT SetHostControl(
    [in] IHostControl* pHostControl
);

Parameter

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

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

Sie müssen SetHostControl aufrufen, bevor die CLR initialisiert wird, d. h., bevor Sie ICLRRuntimeHost::Start-Methode aufrufen oder eine der Metadatenschnittstellen verwenden. Es wird empfohlen, SetHostControl unmittelbar nach einem Aufruf von CorBindToCurrentRuntime-Funktion oder CorBindToRuntimeEx-Funktion aufzurufen.