WSACreateEvent-Funktion (winsock2.h)

Artikel
08/27/2023

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
WSANOTINITIALISIERT	Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen.
WSAENETDOWN	Beim Netzwerksubsystem ist ein Fehler aufgetreten.
WSAEINPROGRESS	Ein blockierter Windows Sockets 1.1-Aufruf wird ausgeführt, oder der Dienstanbieter verarbeitet weiterhin eine Rückruffunktion.
WSA_NOT_ENOUGH_MEMORY	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