Partager via


WSAResetEvent, fonction (winsock2.h)

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

Voir aussi

WSACloseEvent

WSACreateEvent

WSAEnumNetworkEvents

WSAEventSelect

WSASetEvent

Fonctions Winsock

Informations de référence sur Winsock