Funzione WSACloseEvent (winsock2.h)

Articolo
03/13/2024

La funzione WSACloseEvent chiude un handle di oggetti evento aperto.

Sintassi

BOOL WSAAPI WSACloseEvent(
  [in] WSAEVENT hEvent
);

Parametri

[in] hEvent

Handle oggetto che identifica l'evento aperto.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per ottenere informazioni sull'errore estese, chiamare WSAGetLastError.

Codice di errore	Significato
WSANOTINITIALISED	Prima di usare questa funzione, è necessario eseguire una chiamata WSAStartup riuscita.
WSAENETDOWN	Il sottosistema di rete non è riuscito.
WSAEINPROGRESS	Una chiamata windows Sockets 1.1 bloccata è in corso oppure il provider di servizi sta ancora elaborando una funzione di callback.
WSA_INVALID_HANDLE	HEvent non è un handle dell'oggetto evento valido.

Commenti

La funzione WSACloseEvent chiude l'handle a un oggetto evento e libera le risorse associate all'oggetto evento. Questa funzione viene usata per chiudere un handle creato dalla funzione WSACreateEvent . Dopo aver chiuso l'handle all'oggetto evento, altri riferimenti a questo handle avranno esito negativo con l'errore WSA_INVALID_HANDLE.

Windows Phone 8: questa funzione è supportata per le app Windows Phone Store in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8.1, Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	winsock2.h
Libreria	Ws2_32.lib
DLL	Ws2_32.dll