Funzione UnregisterWait (winbase.h)

Annulla un'operazione di attesa registrata rilasciata dalla funzione RegisterWaitForSingleObject .

Per usare un evento di completamento, chiamare la funzione UnregisterWaitEx .

Sintassi

BOOL UnregisterWait(
  [in] HANDLE WaitHandle
);

Parametri

[in] WaitHandle

Handle di attesa. Questo handle viene restituito dalla funzione RegisterWaitForSingleObject .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se le funzioni di callback associate al timer non sono state completate quando viene chiamato UnregisterWait, unregisterWait annulla la registrazione dell'attesa sulle funzioni di callback e non riesce con il codice di errore ERROR_IO_PENDING. Il codice di errore non indica che la funzione non è riuscita e la funzione non deve essere chiamata di nuovo. Se il codice richiede un codice di errore da impostare solo quando l'operazione di annullamento della registrazione non è riuscita, chiamare invece UnregisterWaitEx .

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0500 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winbase.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

Registerwaitforsingleobject

Funzioni di sincronizzazione

Pooling dei thread

UnregisterWaitEx