Funzione WSACreateEvent (winsock2.h)
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 |
|---|---|
| Prima di usare questa funzione, è necessario che venga eseguita una chiamata WSAStartup riuscita. | |
| Il sottosistema di rete non è riuscito. | |
| È in corso una chiamata di Windows Sockets 1.1 bloccante oppure il provider di servizi sta ancora elaborando una funzione di callback. | |
| 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 |