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 |
|---|---|
| Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen. | |
| Fehler beim Netzwerksubsystem. | |
| Ein blockierter Windows Sockets 1.1-Aufruf wird ausgeführt, oder der Dienstanbieter verarbeitet noch eine Rückruffunktion. | |
| 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 |