Partager via


CAsyncSocket::Bind

Appelez la fonction membre pour associer une adresse locale du socket.

BOOL Bind( 
   UINT nSocketPort, 
   LPCTSTR lpszSocketAddress = NULL  
); 
BOOL Bind ( 
   const SOCKADDR* lpSockAddr, 
   int nSockAddrLen  
);

Paramètres

  • nSocketPort
    Le port identificateur l'application de socket.

  • lpszSocketAddress
    l'adresse réseau, un nombre séparé par des points tel que « 128.56.22.8 ». Passant la chaîne de NULL pour ce paramètre indique l'instance de CAsyncSocket doivent écouter l'activité cliente sur toutes les interfaces réseau.

  • lpSockAddr
    Un pointeur vers une structure de SOCKADDR qui contient l'adresse à assigner à ce socket.

  • nSockAddrLen
    La longueur de l'adresse dans lpSockAddr en octets.

Valeur de retour

Une valeur différente de zéro si la fonction est réussie ; sinon 0, et le code d'erreur spécifique peuvent être récupérés en appelant GetLastError. Les erreurs suivantes s'appliquent à cette fonction membre :

  • WSANOTINITIALISED A réussi AfxSocketInit doit se produire avant d'utiliser cette API.

  • WSAENETDOWN que l'implémentation de Windows Sockets l'a détecté que le sous-système réseau a échoué.

  • WSAEADDRINUSE l'adresse spécifiée est déjà en cours de utilisation. (Consultez l'option de socket de SO_REUSEADDR sous SetSockOpt.)

  • WSAEFAULT l'argument d' nSockAddrLen est trop petit (moins que la taille d'une structure de SOCKADDR ).

  • WSAEINPROGRESS se bloque l'appel de Windows Sockets est en cours.

  • WSAEAFNOSUPPORT la famille d'adresse spécifiée n'est pas pris en charge par ce port.

  • WSAEINVAL le socket est déjà lié à une adresse.

  • WSAENOBUFS pas assez met en mémoire tampon disponible, trop de connexions.

  • WSAENOTSOCK le modèle n'est pas un socket.

Notes

Cette routine est utilisé sur un datagramme ou un socket flux non connecté, avant que Connecter suivant ou des appels d' Listen . Avant de pouvoir recevoir des invites de connexion, un socket écoutant de serveur doit sélectionner un numéro de port et le faire connu à Windows Sockets en appelant Liaison. Liaison génère l'association locale (adresse de l'hôte/numéro de port) du socket en assignant un nom local à un socket sans nom.

Configuration requise

Header: afxsock.h

Voir aussi

Référence

CAsyncSocket, classe

Graphique de la hiérarchie

CAsyncSocket::Connect

CAsyncSocket::Listen

CAsyncSocket::GetSockName

CAsyncSocket::SetSockOpt

CAsyncSocket::Create