Freigeben über


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
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

Weitere Informationen

CreateEvent

WSACloseEvent

WSAEnumNetworkEvents

WSAEventSelect

WSAGetOverlappedResult

WSARecv

WSARecvFrom

WSAResetEvent

WSASend

WSASendTo

WSASetEvent

WSAWaitForMultipleEvents

Winsock-Funktionen

Winsock-Referenz