IHostTask::Join-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Blockiert die aufrufende Aufgabe, bis die von der aktuellen IHostTask-Instanz dargestellte Aufgabe abgeschlossen ist, das angegebene Zeitintervall verstrichen ist oder IHostTask::Alert aufgerufen wird.

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

Parameter

milliseconds
[in] Das Zeitintervall in Millisekunden, in dem auf den Abschluss der Aufgabe gewartet werden soll. Wenn dieses Intervall abläuft, bevor die Aufgabe abgeschlossen ist, wird die Blockierung der aufrufenden Aufgabe beendet.
option
[in] Einer der WAIT_OPTION-Werte. Ein WAIT_ALERTABLE-Wert weist den Host an, die Aufgabe zu aktivieren, wenn Alert aufgerufen wird, bevor milliseconds verstrichen sind.

Rückgabewert

HRESULT	Beschreibung
S_OK	Join kehrte erfolgreich zurück.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (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 darauf wartete, oder die aktuelle IHostTask-Instanz ist keiner Aufgabe zugeordnet.
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.