CAsyncSocket::Create

BOOLCreate (UINTnSocketPort=0,intnSocketType=longSOCK_STREAM,lEvent=FD_READ|FD_WRITE|FD_OOB|FD_ACCEPT|FD_CONNECT|FD_CLOSE,LPCTSTRlpszSocketAddress=NULL);

Valeur de retour

Différent de zéro si la fonction est réussie ; sinon, 0 et un code d'erreur spécifique peuvent être récupérée par appeler GetLastError. Les erreurs suivantes s'appliquent à cette fonction membre:

• WSA&NOTINITIALISEDnbsp ;  Un succès AfxSocketInit doit se produire avant d'utiliser cette API.
  
  
• WSAE&NETDOWNnbsp ;  La mise en œuvre des Sockets Windows a détecté que le sous-système réseau n'a pas.
  
  
• WSAEAF&NOSUPPORTnbsp ;  La famille d'adresses spécifiée n'est pas pris en charge.
  
  
• WSAEI&NPROGRESSnbsp ;  Une opération de blocage Windows Sockets est en cours.
  
  
• WSAEMFILEnbsp ;  &N'existent pas plusieurs descripteurs de fichier.
  
  
• WSAE&NOBUFSnbsp ;  Aucun espace de mémoire tampon n'est disponible. Impossible de créer le socket.
  
  
• WSAEPROTO&NOSUPPORTnbsp ;  Le port spécifié n'est pas pris en charge.
  
  
• WSAEPROTOTYPE  ;  Le port spécifié est de type incorrect pour le socket.
  
  
• WSAESOCKT&NOSUPPORTnbsp ;  Le type de socket spécifié n'est pas pris en charge dans cette famille d'adresses.

Paramètres

nSocketPort

Un port bien connu pour être utilisé avec la douille, ou 0 si vous souhaitez que Windows Sockets pour sélectionner un port.

nSocketType

SOCK_STREAM ou SOCK_DGRAM.

lEvent

Un masque de bits qui spécifie une combinaison d'événements de réseau dans lequel l'application s'intéresse.

• FD_READ  ;  Souhaitez recevoir une notification de préparation pour la lecture.
  
  
• FD_WRITE  ;  Souhaitez recevoir une notification de préparation pour l'écriture.
  
  
• FD_OOB  ;  Souhaitez recevoir une notification de l'arrivée des données hors-bande.
  
  
• FD_ACCEPT  ;  Souhaitez recevoir une notification de connexions entrantes.
  
  
• FD_CO&NNECTnbsp ;  Souhaitez recevoir une notification de connexion terminée.
  
  
• FD_CLOSE  ;  Souhaitez recevoir une notification de fermeture de la socket.

lpszSockAddress

Un pointeur vers une chaîne contenant l'adresse réseau de la socket connecté, un nombre en pointillé, comme « 128.56.22.8 ».

Remarques

Appelez la fonction membre de créer après la construction d'un objet socket pour créer le socket Windows et le joindre. Créer puis appelle Bind pour lier le socket à l'adresse spécifiée. Les types de connecteurs suivants sont pris en charge:

• SOCK_STREAM  ;  Fournit des flux d'octets séquencés, fiables, full-duplex, axée sur la connexion. Utilise le protocole TCP (Transmission Control) pour la famille d'adresses Internet.
  
  
• SOCK_DGRAM  ;  Prend en charge des datagrammes, qui sont sans connexion, peu fiables des paquets de longueur maximale fixe (généralement petite). Utilise le protocole UDP (User Datagram) pour la famille d'adresses Internet.

  &Notenbsp ;  La fonction de membre accepte prend une référence à un objet CSocket vide comme son paramètre. Vous devez construire cet objet avant de vous appeler Accept. Gardez à l'esprit que si cet objet socket passe de portée, la fermeture de la connexion. N'appelez pas la création de ce nouvel objet socket.

Pour plus d'informations sur les flux et datagram sockets, consultez les articles Windows Sockets : fond et Windows Sockets : Ports et adresses de Socket dans le Guide du programmeur Visual C++ et vue d'ensemble de Windows Sockets 2 et Considérations de programmation des Sockets Windows dans la documentation du SDK Win32.

Aperçu de CAsyncSocket |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CAsyncSocket::Accept, CAsyncSocket::Bind, CAsyncSocket::Connect, CAsyncSocket::GetSock&Name,CAsyncSocket::IOCtl, CAsyncSocket::Listen, CAsyncSocket::Receive, CAsyncSocket::Send, CAsyncSocket::ShutDown