Fonction WSACloseEvent (winsock2.h)
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 |
|---|---|
| Un appel WSAStartup réussi doit se produire avant d’utiliser cette fonction. | |
| Le sous-système réseau a échoué. | |
| Un appel bloquant Windows Sockets 1.1 est en cours ou le fournisseur de services traite toujours une fonction de rappel. | |
| 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 |