Funzione NtWaitForSingleObject (winternl.h)

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