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 |
---|---|
|
L'oggetto specificato ha soddisfatto l'attesa. |
|
Si è verificato un timeout. |
|
L'attesa è stata interrotta per inviare un avviso al thread corrente. |
|
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 |