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 |