WSACreateEvent, fonction (winsock2.h)

Article
08/27/2023

La fonction WSACreateEvent crée un nouvel objet d’événement.

Syntaxe

WSAEVENT WSAAPI WSACreateEvent();

Valeur de retour

Si aucune erreur ne se produit, WSACreateEvent retourne le handle de l’objet d’événement. Sinon, la valeur de retour est WSA_INVALID_EVENT. 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_NOT_ENOUGH_MEMORY	Mémoire disponible insuffisante pour créer l’objet d’événement.

Remarques

La fonction WSACreateEvent crée un objet d’événement de réinitialisation manuelle avec un état initial non signé. Le handle de l’objet d’événement retourné ne peut pas être hérité par les processus enfants. L’objet d’événement n’est pas nommé.

La fonction WSASetEvent peut être appelée pour définir l’état de l’objet événement sur signal. La fonction WSAResetEvent peut être appelée pour définir l’état de l’objet d’événement sur non signé. Lorsqu’un objet d’événement n’est plus nécessaire, la fonction WSACloseEvent doit être appelée pour libérer les ressources associées à l’objet événement.

Les objets d’événement Windows Sockets 2 sont des objets système dans des environnements Windows. Par conséquent, si une application Windows souhaite utiliser un événement de réinitialisation automatique plutôt qu’un événement de réinitialisation manuelle, l’application peut appeler directement la fonction CreateEvent . L’étendue d’un objet d’événement est limitée au processus dans lequel il est créé.

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