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 |
|---|---|
| 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. | |
| 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 |