DeleteUmsThreadContext, fonction (winbase.h)
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) |