Fonction WSACloseEvent (winsock2.h)

Article
08/27/2023

La fonction WSACloseEvent ferme un handle d’objet d’événement ouvert.

Syntaxe

BOOL WSAAPI WSACloseEvent(
  [in] WSAEVENT hEvent
);

Paramètres

[in] hEvent

Gestionnaire d’objet identifiant l’événement ouvert.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations d’erreur étendues, appelez WSAGetLastError.

Code d'erreur	Signification
WSANOTINITIALISED	Un appel WSAStartup réussi doit se produire avant d’utiliser cette fonction.
WSAENETDOWN	Le sous-système réseau a échoué.
WSAEINPROGRESS	Un appel bloquant Windows Sockets 1.1 est en cours ou le fournisseur de services traite toujours une fonction de rappel.
WSA_INVALID_HANDLE	HEvent n’est pas un handle d’objet d’événement valide.

Remarques

La fonction WSACloseEvent ferme le handle à un objet d’événement et libère les ressources associées à l’objet événement. Cette fonction est utilisée pour fermer un handle créé par la fonction WSACreateEvent . Une fois que le handle de l’objet d’événement est fermé, d’autres références à ce handle échouent avec l’erreur WSA_INVALID_HANDLE.

Windows Phone 8 : cette fonction est prise en charge pour les applications du Store Windows Phone Windows Phone 8 et versions ultérieures.

Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8.1, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winsock2.h
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll