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