Freigeben über


WSAResetEvent-Funktion (winsock2.h)

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

Weitere Informationen

WSACloseEvent

WSACreateEvent

WSAEnumNetworkEvents

WSAEventSelect

WSASetEvent

Winsock-Funktionen

Winsock-Referenz