GetUmsCompletionListEvent, fonction (winbase.h)
Récupère un handle de l’événement associé à la liste de saisie semi-automatique de planification en mode utilisateur (UMS) spécifiée.
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 GetUmsCompletionListEvent(
[in] PUMS_COMPLETION_LIST UmsCompletionList,
[in, out] PHANDLE UmsCompletionEvent
);
Paramètres
[in] UmsCompletionList
Pointeur vers une liste de saisie semi-automatique UMS. La fonction CreateUmsCompletionList fournit ce pointeur.
[in, out] UmsCompletionEvent
Pointeur vers une variable HANDLE. À la sortie, le paramètre UmsCompletionEvent est défini sur un handle pour l’événement associé à la liste d’achèvement spécifiée.
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
Le système signale un événement de liste d’achèvement UMS lorsque le système met en file d’attente des éléments vers une liste d’achèvement vide. Un handle d’événement de liste d’achèvement peut être utilisé avec n’importe quelle fonction d’attente qui prend un handle pour un événement. Lorsque l’événement est signalé, une application appelle généralement DequeueUmsCompletionListItems pour récupérer le contenu de la liste d’achèvement.
Le handle d’événement reste valide jusqu’à ce que sa liste d’achèvement soit supprimée. N’utilisez pas le handle d’événement pour attendre une liste de saisie semi-automatique qui a été supprimée ou qui est en cours de suppression.
Lorsque le handle n’est plus nécessaire, utilisez la fonction CloseHandle pour fermer le handle.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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) |