Funzione ResetEvent (synchapi.h)

Articolo
08/26/2023

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