ICLRRuntimeHost::SetHostControl-Methode
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.