Funzione WSACreateEvent (winsock2.h)

Articolo
03/08/2023

La funzione WSACreateEvent crea un nuovo oggetto evento.

Sintassi

WSAEVENT WSAAPI WSACreateEvent();

Valore restituito

Se non si verifica alcun errore, WSACreateEvent restituisce l'handle dell'oggetto evento. In caso contrario, il valore restituito è WSA_INVALID_EVENT. Per ottenere informazioni estese sull'errore, chiamare WSAGetLastError.

Codice di errore	Significato
WSANOTINITIALISED	Prima di usare questa funzione, è necessario che venga eseguita una chiamata WSAStartup riuscita.
WSAENETDOWN	Il sottosistema di rete non è riuscito.
WSAEINPROGRESS	È in corso una chiamata di Windows Sockets 1.1 bloccante oppure il provider di servizi sta ancora elaborando una funzione di callback.
WSA_NOT_ENOUGH_MEMORY	Memoria disponibile insufficiente per creare l'oggetto evento.

Commenti

La funzione WSACreateEvent crea un oggetto evento di reimpostazione manuale con uno stato iniziale non firmato. L'handle dell'oggetto evento restituito non può essere ereditato dai processi figlio. L'oggetto evento è senza nome.

È possibile chiamare la funzione WSASetEvent per impostare lo stato dell'oggetto evento su segnalato. È possibile chiamare la funzione WSAResetEvent per impostare lo stato dell'oggetto evento su nonsignaled. Quando un oggetto evento non è più necessario, la funzione WSACloseEvent deve essere chiamata per liberare le risorse associate all'oggetto evento.

Gli oggetti evento Windows Sockets 2 sono oggetti di sistema negli ambienti Windows. Pertanto, se un'applicazione Windows vuole usare un evento di reimpostazione automatica anziché un evento di reimpostazione manuale, l'applicazione può chiamare direttamente la funzione CreateEvent . L'ambito di un oggetto evento è limitato al processo in cui viene creato.

Windows Phone 8: questa funzione è supportata per le app dello Store di Windows Phone in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti


Client minimo supportato	Windows 8.1, Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winsock2.h
Libreria	Ws2_32.lib
DLL	Ws2_32.dll