CAsyncSocket::Listen

BOOL Écouter ( int nConnectionBacklog = 5 );

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.
  
  
• WSAEADDRI&NUSEnbsp ;  Une tentative a été déposée à l'écoute sur une adresse dans l'utilisation.
  
  
• WSAEI&NPROGRESSnbsp ;  Une opération de blocage Windows Sockets est en cours.
  
  
• WSAEI&NVALnbsp ;  Le socket n'a pas été lié avec lier ou est déjà connecté.
  
  
• WSAEISCO&NNnbsp ;  Le socket est déjà connecté.
  
  
• WSAEMFILEnbsp ;  &N'existent pas plusieurs descripteurs de fichier.
  
  
• WSAE&NOBUFSnbsp ;  Aucun espace de mémoire tampon n'est disponible.
  
  
• WSAE&NOTSOCKnbsp ;  Le descripteur n'est pas un socket.
  
  
• WSAEOP&NOTSUPPnbsp ;  Le socket référencé n'est pas d'un type qui prend en charge l'opération d'écoute.

Paramètres

nConnectionBacklog

La longueur maximale à laquelle peut atteindre la file d'attente de connexions. Plage valide s'étend de 1 à 5.

Remarques

Appelez cette fonction membre pour écouter les demandes de connexion entrantes. Pour accepter les connexions, le socket est créé avec la création, un retard pour les connexions entrantes est spécifié avec l'écoute, et puis les connexions sont acceptées avec Accept. S'écouter applique uniquement aux sockets qui prennent en charge les connexions, c'est-à-dire, ceux de type SOCK_STREAM. Cette attache est mises en mode « passif » où les connexions entrantes sont reconnues et en file d'attente en attente de l'acceptation par le processus.

Cette fonction est généralement utilisée par les serveurs (ou toute application qui souhaite accepter les connexions) qui pourrait avoir plus d'une demande de connexion à la fois : si une demande de connexion arrive avec la file d'attente pleine, le client recevra une erreur avec une indication de WSAECONNREFUSED.

Écouter tente de continuer à fonctionner de façon rationnelle lorsqu'il n'y a aucun ports disponibles (descripteurs). Il acceptera des connexions jusqu'à ce que la file d'attente est vide. Si les ports sont disponibles, un appel ultérieur à écouter ou à accepter va recharger la file d'attente à le « arriéré » actuel ou plus récente, si possible et reprenez l'écoute pour les connexions entrantes.

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

Voir aussi  ;CAsyncSocket::Accept, CAsyncSocket::Connect, CAsyncSocket::Create