CAsyncSocket::Send

virtual int Enviar ( const void * lpBuf, int nBufLen, int nFlags = 0 );

Valor devuelto

Si se produce ningún error, Enviar devuelve el número total de caracteres enviados. (Tenga en cuenta que esto puede ser menor que el número indicado por nBufLen.) De lo contrario, se devuelve un valor de SOCKET_ERROR y un código de error específico puede ser obtenido 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.
  
  
• WSAEACCES   La dirección solicitada es una dirección de difusión, pero no se estableció la bandera adecuada.
  
  
• WSAEI&NPROGRESSnbsp;  Está en curso una operación bloqueo de Windows Sockets.
  
  
• WSAEFAULT   El argumento lpBuf no es en una parte del espacio de dirección de usuario válida.
  
  
• WSAE&NETRESETnbsp;  Debe restablecer la conexión porque la aplicación de Windows Sockets cayó lo.
  
  
• WSAE&NOBUFSnbsp;  La aplicación de Windows Sockets informes un interbloqueo de búfer.
  
  
• WSAE&NOTCONNnbsp;  El socket no está conectado.
  
  
• WSAE&NOTSOCKnbsp;  El descriptor no es un socket.
  
  
• WSAEOP&NOTSUPPnbsp;  Se especificó MSG_OOB , pero el socket no es del tipo SOCK_STREAM.
  
  
• WSAESHUTDOW&Nnbsp;  El socket se ha cerrado; no es posible llamar Enviar en un socket después de apagado se ha invocado con nHow establecido en 1 o 2.
  
  
• WSAEWOULDBLOCK   El zócalo está marcado como bloqueos y bloquearía la operación solicitada.
  
  
• WSAEMSGSIZE   El zócalo es de tipo SOCK_DGRAM, y el datagrama es mayor que el máximo admitido por la aplicación de Windows Sockets.
  
  
• WSAEI&NVALnbsp;  El socket no se ha enlazado con Bind.
  
  
• WSAECO&NNABORTEDnbsp;  El circuito virtual fue abortado debido al tiempo de espera y otros fallos.
  
  
• WSAECO&NNRESETnbsp;  El circuito virtual se restableció por el lado remoto.

Parámetros

lpBuf

Un búfer que contiene los datos a ser transmitidos.

nBufLen

La longitud de los datos de lpBuf en bytes.

nFlags

Especifica la forma en que se realiza la llamada. La semántica de esta función está determinada por las opciones de socket y el parámetro nFlags . Este último se construye mediante la combinación de cualquiera de los siguientes valores con el operador C++ o:

• MSG_DO&NTROUTEnbsp;  Especifica que los datos no deben estar sujetos a enrutamiento. Un proveedor de Windows Sockets puede optar por ignorar este indicador; Véase también la discusión de la opción de SO_DONTROUTE en Consideraciones de programación de Windows Sockets en la documentación del SDK de Win32.
  
  
• MSG_OOB   Enviar datos fuera de banda (sóloSOCK_STREAM ).

Observaciones

Llame a esta función miembro para enviar datos en un socket conectado. Enviar se utiliza para escribir datos salientes en secuencia conectada o sockets de datagramas. Para sockets de datagramas, debe tenerse cuidado no debe exceder el IP tamaño máximo de paquete de las subredes subyacentes, que es dado por el elemento iMaxUdpDg de la estructura WSADATA devuelto por AfxSocketInit. Si los datos son demasiado largos para pasar automáticamente a través del protocolo subyacente, se devuelve el error WSAEMSGSIZE vía GetLastError, y no se transmite ningún dato.

Tenga en cuenta que para un datagrama socket la realización exitosa de un envío no indican que se ha entregado correctamente los datos.

CAsyncSocket objetos de tipo SOCK_STREAM, el número de bytes escritos puede ser entre 1 y la longitud solicitada, dependiendo de la disponibilidad de búfer en los hosts locales y extranjeros.

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

Vea tambié&nnbsp;CAsyncSocket::Create, CAsyncSocket::Receive, CAsyncSocket::ReceiveFrom, estas