Freigeben über


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

Weitere Informationen

WSACreateEvent

WSAEnumNetworkEvents

WSAEventSelect

WSAGetOverlappedResult

WSARecv

WSARecvFrom

WSAResetEvent

WSASend

WSASendTo

WSASetEvent

WSAWaitForMultipleEvents

Winsock-Funktionen

Winsock-Referenz