Partager via


IHostTask::Join, méthode

Bloque la tâche appelante jusqu'à ce que la tâche représentée par l'instance IHostTask actuelle se termine, que l'intervalle de temps spécifié arrive à expiration ou que IHostTask::Alert soit appelé.

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

Paramètres

  • milliseconds
    [in] Intervalle de temps, en millisecondes, à attendre pour que la tâche se termine. Si cet intervalle s'écoule avant que la tâche ne se termine, la tâche appelante se débloque.

  • option
    [in] Une des valeurs WAIT_OPTION. Une valeur WAIT_ALERTABLE indique à l'hôte qu'il doit réactiver la tâche si Alert est appelé avant que milliseconds s'écoulent.

Valeur de retour

HRESULT

Description

S_OK

Join a été retourné avec succès.

HOST_E_CLRNOTAVAILABLE

Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.

HOST_E_TIMEOUT

L'appel a expiré.

HOST_E_NOT_OWNER

L'appelant ne possède pas le verrou.

HOST_E_ABANDONED

Un événement a été annulé alors qu'un thread bloqué ou une fibre l'attendait ou l'instance IHostTask en cours n'est pas associée à une tâche.

E_FAIL

Une défaillance grave et inconnue s'est produite. Lorsqu'une méthode retourne E_FAIL, le CLR n'est plus utilisable dans le processus. Les appels suivants aux méthodes d'hébergement retournent HOST_E_CLRNOTAVAILABLE.

Configuration requise

Plateformes : consultez Configuration requise du .NET Framework.

En-tête : MSCorEE.h

Bibliothèque : incluse en tant que ressource dans MSCorEE.dll

Versions du .NET Framework : 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Voir aussi

Référence

ICLRTask, interface

ICLRTaskManager, interface

IHostTask, interface

IHostTaskManager, interface

WAIT_OPTION, énumération