DeleteUmsThreadContext, fonction (winbase.h)

  • Article

Supprime le contexte de thread de planification en mode utilisateur (UMS) spécifié. Le thread doit être arrêté.

Avertissement

À partir de Windows 11, la planification en mode utilisateur n’est pas prise en charge. Tous les appels échouent avec l’erreur ERROR_NOT_SUPPORTED.

Syntaxe

BOOL DeleteUmsThreadContext(
  [in] PUMS_CONTEXT UmsThread
);

Paramètres

[in] UmsThread

Pointeur vers le contexte de thread UMS à supprimer. La fonction CreateUmsThreadContext fournit ce pointeur.

Valeur retournée

Si la fonction réussit, elle retourne une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Un contexte de thread UMS ne peut pas être supprimé tant que le thread associé n’est pas terminé.

Lorsqu’un thread de travail UMS termine son exécution (par exemple, en retournant à partir de sa fonction de point d’entrée de thread), le système arrête le thread, définit le status d’arrêt dans le contexte de thread UMS du thread et met en file d’attente le contexte de thread UMS vers la liste d’achèvement associée.

Toute tentative d’exécution du thread UMS échouera, car le thread est déjà terminé.

Pour case activée la status d’arrêt d’un thread, le planificateur de l’application doit appeler QueryUmsThreadInformation avec la classe d’informations UmsIsThreadTerminated.

Configuration requise

   
Client minimal pris en charge Windows 7 (64 bits uniquement) [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll
Ensemble d’API api-ms-win-core-ums-l1-1-0 (introduit dans Windows 7)

Voir aussi

CreateUmsThreadContext

QueryUmsThreadInformation