Funzione ResetEvent (synchapi.h)
Imposta l'oggetto evento specificato sullo stato non firmato.
Sintassi
BOOL ResetEvent(
[in] HANDLE hEvent
);
Parametri
[in] hEvent
Handle per l'oggetto evento. La funzione CreateEvent o OpenEvent restituisce questo handle.
L'handle deve avere il diritto di accesso EVENT_MODIFY_STATE. Per altre informazioni, vedere Synchronization Object Security and Access Rights.For more information, see Synchronization Object Security and Access Rights.
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
Lo stato di un oggetto evento rimane non assegnato finché non viene impostato in modo esplicito su segnalato dalla funzione SetEvent o PulseEvent . Questo stato non firmato blocca l'esecuzione di tutti i thread che hanno specificato l'oggetto evento in una chiamata a una delle funzioni di attesa.
La funzione ResetEvent viene usata principalmente per gli oggetti evento di reimpostazione manuale, che devono essere impostati in modo esplicito sullo stato non firmato. Gli oggetti evento di reimpostazione automatica passano automaticamente da segnalato a non assegnato dopo il rilascio di un singolo thread in attesa.
La reimpostazione di un evento che è già reimpostato non ha alcun effetto.
Requisiti
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | synchapi.h (include Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |