Share via


CAsyncSocket::Bind

Llame a esta función miembro para asociar una dirección local con el socket.

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

Parámetros

  • nSocketPort
    El puerto que identifica la aplicación de socket.

  • lpszSocketAddress
    La dirección de red, un número dotted como “128.56.22.8”.Pasar la cadena nula para este parámetro indica que la instancia de CAsyncSocket debe escuchar actividad de cliente en todas las interfaces de red.

  • lpSockAddr
    Un puntero a una estructura de SOCKADDR que contiene la dirección a la asignación a este socket.

  • nSockAddrLen
    la longitud de la dirección en lpSockAddr en bytes.

Valor devuelto

Distinto de cero si la función es correcta; si no 0, y un código de error específico puede recuperar llamando a GetLastError.Los errores siguientes se aplican a esta función miembro:

  • WSANOTINITIALISED A AfxSocketInit correcto debe aparecer antes de utilizar esta API.

  • La implementación de Windows Sockets deWSAENETDOWN The detectó que produjo el subsistema de la red.

  • La dirección especificada speedWSAEADDRINUSE ya está en uso.(Vea la opción de socket de SO_REUSEADDR en SetSockOpt.)

  • El argumento deWSAEFAULT The nSockAddrLen es demasiado pequeño (menor que el tamaño de una estructura de SOCKADDR ).

  • La llamada de Windows Sockets de bloqueo deWSAEINPROGRESS A está en curso.

  • Este puerto no admite la familia especificada speed la dirección deWSAEAFNOSUPPORT .

  • El socket deWSAEINVAL The ya está enlazado a una dirección.

  • WSAENOBUFS No suficientes almacena en búfer disponible, demasiadas conexiones.

  • WSAENOTSOCK El descriptor no es un socket.

Comentarios

Esta rutina se utiliza en un datagrama o un socket de secuencia no relacionado, antes de que Conectar subsiguiente o llamadas de Listen .Antes de que puede aceptar solicitudes de conexión, un socket de servidor que escucha debe seleccionar un número de puerto y facilitar conocido a Windows Sockets llamando a enlace.enlace establece la asociación local (dirección del host y número de puerto) de socket asignando un nombre local a un socket sin nombre.

Requisitos

encabezado: afxsock.h

Vea también

Referencia

Clase de CAsyncSocket

Gráfico de jerarquía

CAsyncSocket::Connect

CAsyncSocket::Listen

CAsyncSocket::GetSockName

CAsyncSocket::SetSockOpt

CAsyncSocket::Create