Funzione NtWaitForSingleObject (winternl.h)

Articolo
03/04/2024

Deprecato. Attende fino a quando l'oggetto specificato non ottiene uno stato di signaled. NtWaitForSingleObject viene sostituito da WaitForSingleObject.

Sintassi

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

Parametri

[in] Handle

Handle per l'oggetto wait.

[in] Alertable

Specifica se un avviso può essere recapitato quando l'oggetto è in attesa.

true

L'avviso può essere recapitato.

FALSE

Impossibile recapitare l'avviso.

[in] Timeout

Puntatore a un tempo assoluto o relativo in cui si verifica l'attesa. Può essere null. Se viene specificato un timeout e l'oggetto non ha raggiunto uno stato di signaled quando scade il timeout, l'attesa viene soddisfatta automaticamente. Se viene specificato un valore di timeout esplicito pari a zero, non si verifica alcuna attesa se l'attesa non può essere soddisfatta immediatamente.

Valore restituito

Stato di completamento dell'attesa. I vari valori NTSTATUS sono definiti in NTSTATUS. H, distribuito con Windows DDK.

Codice restituito	Descrizione
STATUS_SUCCESS	L'oggetto specificato ha soddisfatto l'attesa.
STATUS_TIMEOUT	Si è verificato un timeout.
STATUS_ALERTED	L'attesa è stata interrotta per inviare un avviso al thread corrente.
STATUS_USER_APC	L'attesa è stata interrotta per recapitare una chiamata asincrona (APC) dell'utente al thread corrente.

Commenti

Poiché non è disponibile alcuna libreria di importazione per questa funzione, è necessario usare GetProcAddress.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winternl.h
Libreria	ntdll.lib
DLL	ntdll.dll

Condividi tramite