Partager via


WSACreateEvent, fonction (winsock2.h)

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

Voir aussi

CreateEvent

WSACloseEvent

WSAEnumNetworkEvents

WSAEventSelect

WSAGetOverlappedResult

WSARecv

WSARecvFrom

WSAResetEvent

WSASend

WSASendTo

WSASetEvent

WSAWaitForMultipleEvents

Fonctions Winsock

Informations de référence sur Winsock