WSACreateEvent-Funktion (winsock2.h)
Die WSACreateEvent-Funktion erstellt ein neues Ereignisobjekt.
Syntax
WSAEVENT WSAAPI WSACreateEvent();
Rückgabewert
Wenn kein Fehler auftritt, gibt WSACreateEvent das Handle des Ereignisobjekts zurück. Andernfalls wird der Rückgabewert WSA_INVALID_EVENT. Rufen Sie WSAGetLastError auf, um erweiterte Fehlerinformationen zu erhalten.
| Fehlercode | Bedeutung |
|---|---|
| Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen. | |
| Beim Netzwerksubsystem ist ein Fehler aufgetreten. | |
| Ein blockierter Windows Sockets 1.1-Aufruf wird ausgeführt, oder der Dienstanbieter verarbeitet weiterhin eine Rückruffunktion. | |
| Zum Erstellen des Ereignisobjekts steht nicht genügend freier Arbeitsspeicher zur Verfügung. |
Hinweise
Die WSACreateEvent-Funktion erstellt ein Ereignisobjekt mit manuellem Zurücksetzen mit dem Anfangszustand nicht signalisiert. Das Handle des zurückgegebenen Ereignisobjekts kann nicht von untergeordneten Prozessen geerbt werden. Das Ereignisobjekt ist unbenannt.
Die WSASetEvent-Funktion kann aufgerufen werden, um den Status des Ereignisobjekts auf signalisiert festzulegen. Die WSAResetEvent-Funktion kann aufgerufen werden, um den Status des Ereignisobjekts auf nicht signalisiert festzulegen. Wenn ein Ereignisobjekt nicht mehr benötigt wird, sollte die WSACloseEvent-Funktion aufgerufen werden, um die dem Ereignisobjekt zugeordneten Ressourcen freizugeben.
Windows Sockets 2-Ereignisobjekte sind Systemobjekte in Windows-Umgebungen. Wenn eine Windows-Anwendung daher ein Ereignis zum automatischen Zurücksetzen anstelle eines manuellen Zurücksetzens verwenden möchte, kann die Anwendung die CreateEvent-Funktion direkt aufrufen. Der Bereich eines Ereignisobjekts ist auf den Prozess beschränkt, in dem es erstellt wird.
Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps auf Windows Phone 8 und höher unterstützt.
Windows 8.1 und Windows Server 2012 R2: Diese Funktion wird für Windows Store-Apps unter Windows 8.1, Windows Server 2012 R2 und höher unterstützt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8.1, Windows Vista [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winsock2.h |
| Bibliothek | Ws2_32.lib |
| DLL | Ws2_32.dll |