WSACloseEvent-Funktion (winsock2.h)
Die WSACloseEvent-Funktion schließt ein geöffnetes Ereignisobjekthandle.
Syntax
BOOL WSAAPI WSACloseEvent(
[in] WSAEVENT hEvent
);
Parameter
[in] hEvent
Objekthandle, das das open-Ereignis identifiziert.
Rückgabewert
Wenn die 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. | |
| Das hEvent ist kein gültiges Ereignisobjekthandle. |
Hinweise
Die WSACloseEvent-Funktion schließt das Handle für ein Ereignisobjekt und gibt ressourcen frei, die dem Ereignisobjekt zugeordnet sind. Diese Funktion wird verwendet, um ein von der WSACreateEvent-Funktion erstelltes Handle zu schließen. Sobald das Handle für das Ereignisobjekt geschlossen wurde, schlagen weitere Verweise auf dieses Handle fehl, und der Fehler WSA_INVALID_HANDLE.
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 auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |