WSAResetEvent-Funktion (winsock2.h)

Artikel
08/27/2023

Die WSAResetEvent-Funktion setzt den Zustand des angegebenen Ereignisobjekts auf nicht signalisiert zurück.

Syntax

BOOL WSAAPI WSAResetEvent(
  [in] WSAEVENT hEvent
);

Parameter

[in] hEvent

Ein Handle, das ein geöffnetes Ereignisobjekthandle identifiziert.

Rückgabewert

Wenn die WSAResetEvent-Funktion erfolgreich ist, ist der Rückgabewert TRUE. Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie WSAGetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Fehlercode	Bedeutung
WSANOTINITIALISIERT	Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen.
WSAENETDOWN	Fehler beim Netzwerksubsystem.
WSAEINPROGRESS	Ein blockierter Windows Sockets 1.1-Aufruf wird ausgeführt, oder der Dienstanbieter verarbeitet noch eine Rückruffunktion.
WSA_INVALID_HANDLE	Der hEvent-Parameter ist kein gültiges Ereignisobjekthandle.

Hinweise

Die WSAResetEvent-Funktion wird verwendet, um den Status des Ereignisobjekts auf nicht signalisiert festzulegen.

Die richtige Möglichkeit zum Zurücksetzen des Zustands eines Ereignisobjekts, das mit der WSAEventSelect-Funktion verwendet wird, besteht darin, das Handle des Ereignisobjekts an die WSAEnumNetworkEvents-Funktion im hEventObject-Parameter zu übergeben. Dadurch wird das Ereignisobjekt zurückgesetzt und die status aktiver FD-Ereignisse im Socket auf atomare Weise angepasst.

Windows Phone 8: Diese Funktion wird für Windows Phone Store-Apps ab Windows Phone 8 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