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

Classe de CAsyncSocket

Graphique de la hiérarchie

CAsyncSocket::Connect

CAsyncSocket::Listen

CAsyncSocket::GetSockName

CAsyncSocket::SetSockOpt

CAsyncSocket::Create