WSAResetEvent, fonction (winsock2.h)

Article
08/27/2023

La fonction WSAResetEvent réinitialise l’état de l’objet d’événement spécifié sur non signé.

Syntaxe

BOOL WSAAPI WSAResetEvent(
  [in] WSAEVENT hEvent
);

Paramètres

[in] hEvent

Handle qui identifie un handle d’objet d’événement ouvert.

Valeur retournée

Si la fonction WSAResetEvent 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	Le paramètre hEvent n’est pas un handle d’objet d’événement valide.

Remarques

La fonction WSAResetEvent est utilisée pour définir l’état de l’objet d’événement sur non signé.

Le bon moyen de réinitialiser l’état d’un objet d’événement utilisé avec la fonction WSAEventSelect consiste à passer le handle de l’objet d’événement à la fonction WSAEnumNetworkEvents dans le paramètre hEventObject . Cela réinitialise l’objet d’événement et ajuste le status des événements FD actifs sur le socket de manière atomique.

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


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