Funzione SetEvent (synchapi.h)
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 |