CAsyncSocket::Create

BOOL Crear ( UINT nSocketPort = 0, int nSocketType = SOCK_STREAM, largo lEvent = FD_READ | FD_WRITE | FD_OOB | FD_ACCEPT | FD_CONNECT | FD_CLOSE, LPCTSTR lpszSocketAddress = Nulo );

Valor devuelto

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

• WSA&NOTINITIALISEDnbsp;  Un éxito AfxSocketInit debe producirse antes de utilizar este API.
  
  
• WSAE&NETDOWNnbsp;  La aplicación de Windows Sockets detecta que el subsistema de red no.
  
  
• WSAEAF&NOSUPPORTnbsp;  La familia de direcciones especificado no es compatible.
  
  
• WSAEI&NPROGRESSnbsp;  Está en curso una operación bloqueo de Windows Sockets.
  
  
• WSAEMFILEnbsp;  &No más descriptores de archivo están disponibles.
  
  
• WSAE&NOBUFSnbsp;  No hay espacio de búfer está disponible. No se puede crear el socket.
  
  
• WSAEPROTO&NOSUPPORTnbsp;  El puerto especificado no es compatible.
  
  
• WSAEPROTOTYPE   El puerto especificado es del tipo correcto para este socket.
  
  
• WSAESOCKT&NOSUPPORTnbsp;  El tipo de socket especificado no es compatible con esta familia de direcciones.

Parámetros

nSocketPort

Un puerto para ser usado con el zócalo, o 0 si desea que Windows Sockets para seleccionar un puerto.

nSocketType

SOCK_STREAM o SOCK_DGRAM.

lEvent

Una máscara de bits que especifica una combinación de eventos de la red en la que está interesada la aplicación.

• FD_READ   Desea recibir una notificación de preparación para la lectura.
  
  
• FD_WRITE   Desea recibir una notificación de preparación para la escritura.
  
  
• FD_OOB   Desea recibir una notificación de la llegada de datos fuera de banda.
  
  
• FD_ACCEPT   Desea recibir notificación de las conexiones entrantes.
  
  
• FD_CO&NNECTnbsp;  Desea recibir una notificación de conexión completa.
  
  
• FD_CLOSE   Desea recibir una notificación de cierre de socket.

lpszSockAddress

Un puntero a una cadena que contiene la dirección de red del socket conectado, un número de puntos como "128.56.22.8".

Observaciones

Llame a la función miembro Create después de construir un objeto socket para crear el socket de Windows y adjuntarlo. Crear llama a enlazar con el socket se unen a la dirección especificada. Se admiten los siguientes tipos de socket:

• SOCK_STREAM   Proporciona secuencias de bytes secuenciados, confiable, full-duplex, basada en la conexión. Utiliza el Protocolo de Control de transmisión (TCP) para la familia de direcciones de Internet.
  
  
• SOCK_DGRAM   Datagramas de apoyos, que son paquetes sin conexión y no confiables de una longitud fija de máximo (normalmente pequeño). Utiliza el Protocolo de datagrama de usuario (UDP) para la familia de direcciones de Internet.

  &Notanbsp;  La función de miembro de Aceptar toma una referencia a un objeto de CSocket nuevo y vacío como su parámetro. Debe construir este objeto antes de llamar a Aceptar. Tenga en cuenta que si este objeto socket sale del ámbito de aplicación, el cierre de la conexión. No llame a crear este nuevo objeto socket.

Para obtener más información acerca de sockets stream y datagrama, vea los artículos Windows Sockets: Fondo y Windows Sockets: puertos y direcciones de Socket en la Guía del programador de Visual C++ y Descripción general de Windows Sockets 2 y Consideraciones de programación de Windows Sockets en la documentación del SDK de Win32.

Introducción a CAsyncSocket |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp;CAsyncSocket::Accept, CAsyncSocket::Bind, CAsyncSocket::Connect, CAsyncSocket::GetSock&Name,CAsyncSocket::IOCtl, CAsyncSocket::Listen, CAsyncSocket::Receive, CAsyncSocket::Send, CAsyncSocket::ShutDown