Freigeben über

IHostTask::Join-Methode

  • Artikel

Blockiert den aufrufenden Task, bis der durch die aktuelle IHostTask-Instanz dargestellte Task abgeschlossen ist, das angegebene Zeitintervall verstreicht oder IHostTask::Alert aufgerufen wird.

Syntax

HRESULT Join (  
    [in] DWORD milliseconds,  
    [in] DWORD option  
);

Parameter

milliseconds
[in] Das Zeitintervall in Millisekunden, das auf das Beenden des Tasks gewartet werden soll. Wenn dieses Intervall verstrichen ist, bevor der Task beendet wurde, wird die Blockierung des aufrufenden Tasks aufgehoben.

option
[in] Einer der WAIT_OPTION-Werte. Der Wert WAIT_ALERTABLE weist den Host an, den Task zu reaktivieren, wenn Alert vor Ablauf von milliseconds aufgerufen wird.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK Join wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE Die Common Language Runtime (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 Fiber darauf wartete, oder die aktuelle IHostTask-Instanz ist keinem Task zugeordnet.
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.

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