ICLRRuntimeHost::SetHostControl-Methode
Aktualisiert: November 2007
Legt den Schnittstellenzeiger fest, mit dem die Common Language Runtime (CLR) die Hostimplementierung von IHostControl abrufen kann.
HRESULT SetHostControl(
[in] IHostControl* pHostControl
);
Parameter
- pHostControl
[in] Ein Schnittstellenzeiger auf die Implementierung von IHostControl des Hosts.
Rückgabewert
HRESULT |
Beschreibung |
---|---|
S_OK |
SetHostControl kehrte erfolgreich zurück. |
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. |
Hinweise
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.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: MSCorEE.idl
Bibliothek: als Ressource in MSCorEE.dll enthalten
.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0