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