Fonction NtWaitForSingleObject (winternl.h)

Article
03/04/2024

Action déconseillée. Attend que l’objet spécifié atteigne l’état .signaled NtWaitForSingleObject est remplacé par WaitForSingleObject.

Syntaxe

NTSTATUS NtWaitForSingleObject(
  [in] HANDLE         Handle,
  [in] BOOLEAN        Alertable,
  [in] PLARGE_INTEGER Timeout
);

Paramètres

[in] Handle

Handle de l’objet wait.

[in] Alertable

Spécifie si une alerte peut être remise lorsque l’objet est en attente.

TRUE

L’alerte peut être remise.

FALSE

L’alerte ne peut pas être remise.

[in] Timeout

Pointeur vers une durée absolue ou relative pendant laquelle l’attente doit se produire. Peuvent avoir la valeur null. Si un délai d’expiration est spécifié et que l’objet n’a pas atteint l’état à l’expiration du signaled délai d’expiration, l’attente est automatiquement satisfaite. Si une valeur de délai d’expiration explicite de zéro est spécifiée, aucune attente ne se produit si l’attente ne peut pas être satisfaite immédiatement.

Valeur retournée

Status d’achèvement de l’attente. Les différentes valeurs NTSTATUS sont définies dans NTSTATUS. H, qui est distribué avec le DDK Windows.

Code de retour	Description
STATUS_SUCCESS	L’objet spécifié a satisfait à l’attente.
STATUS_TIMEOUT	Un délai d’expiration s’est produit.
STATUS_ALERTED	L’attente a été abandonnée pour remettre une alerte au thread actuel.
STATUS_USER_APC	L’attente a été abandonnée pour remettre un appel de procédure asynchrone (APC) utilisateur au thread actuel.

Remarques

Étant donné qu’il n’existe aucune bibliothèque d’importation pour cette fonction, vous devez utiliser GetProcAddress.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winternl.h
Bibliothèque	ntdll.lib
DLL	ntdll.dll

Partager via