Condividi tramite


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

Vedere anche

CreateEvent

Oggetti evento

OpenEvent

PulseEvent

SetEvent

Funzioni di sincronizzazione