Funzione SetEvent (synchapi.h)

Articolo
03/13/2024

Imposta l'oggetto evento specificato sullo stato segnalato.

Sintassi

BOOL SetEvent(
  [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 Sicurezza oggetti di sincronizzazione e diritti di accesso.

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 di reimpostazione manuale rimane segnalato fino a quando non viene impostato in modo esplicito sullo stato non assegnato dalla funzione ResetEvent . Qualsiasi numero di thread in attesa o thread che iniziano successivamente operazioni di attesa per l'oggetto evento specificato chiamando una delle funzioni di attesa, può essere rilasciata mentre lo stato dell'oggetto viene segnalato.

Al contrario, lo stato di un oggetto evento di reimpostazione automatica rimane segnalato fino a quando non viene rilasciato un singolo thread in attesa, al momento in cui il sistema imposta automaticamente lo stato su non assegnato. Se non c'è alcun thread in attesa, lo stato dell'oggetto evento resta segnalato.

L'impostazione di un evento già impostato non ha alcun effetto.

Le app di Windows Store possono rispondere agli eventi denominati e ai semafori denominati, come descritto in Come rispondere a eventi e semafori denominati.

Esempio

Per un esempio che usa SetEvent, vedere Uso di oggetti evento.

Requisiti

Requisito	Valore
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 (includere Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll