WSACloseEvent-Funktion (winsock2.h)

Artikel
03/04/2024

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