función recvfrom (winsock.h)

La función recvfrom recibe un datagrama y almacena la dirección de origen.

Sintaxis

int recvfrom(
  [in]                SOCKET   s,
  [out]               char     *buf,
  [in]                int      len,
  [in]                int      flags,
  [out]               sockaddr *from,
  [in, out, optional] int      *fromlen
);

Parámetros

[in] s

Descriptor que identifica un socket enlazado.

[out] buf

Un búfer para los datos entrantes.

[in] len

Longitud, en bytes, del búfer al que apunta el parámetro buf .

[in] flags

Conjunto de opciones que modifican el comportamiento de la llamada de función más allá de las opciones especificadas para el socket asociado. Consulte los comentarios siguientes para obtener más detalles.

[out] from

Puntero opcional a un búfer en una estructura sockaddr que contendrá la dirección de origen tras la devolución.

[in, out, optional] fromlen

Puntero opcional al tamaño, en bytes, del búfer al que apunta el parámetro from .

Valor devuelto

Si no se produce ningún error, recvfrom devuelve el número de bytes recibidos. Si la conexión se ha cerrado correctamente, el valor devuelto es cero. De lo contrario, se devuelve un valor de SOCKET_ERROR y se puede recuperar un código de error específico mediante una llamada a WSAGetLastError.

Comentarios

La función recvfrom lee los datos entrantes en sockets conectados y no conectados y captura la dirección desde la que se enviaron los datos. Esta función se usa normalmente con sockets sin conexión. La dirección local del socket debe conocerse. En el caso de las aplicaciones de servidor, esto normalmente se realiza explícitamente a través del enlace. No se recomienda el enlace explícito para las aplicaciones cliente. Para las aplicaciones cliente que usan esta función, el socket se puede enlazar implícitamente a una dirección local a través de sendto, WSASendTo o WSAJoinLeaf.

En el caso de sockets orientados a flujos, como los de tipo SOCK_STREAM, una llamada a recvfrom devuelve tanta información como está disponible actualmente, hasta el tamaño del búfer especificado. Si el socket se ha configurado para la recepción en línea de datos OOB (opción de socket SO_OOBINLINE) y los datos de OOB todavía no son leídos, solo se devolverán los datos de OOB. La aplicación puede usar el comando ioctlsocket o WSAIoctlSIOCATMARK para determinar si se deben leer más datos de OOB. Los parámetros from y fromlen se omiten para los sockets orientados a la conexión.

En el caso de los sockets orientados a mensajes, los datos se extraen del primer mensaje en cola, hasta el tamaño del búfer especificado. Si el datagrama o mensaje es mayor que el búfer especificado, el búfer se rellena con la primera parte del datagrama y recvfrom genera el error WSAEMSGSIZE. En el caso de los protocolos no confiables (por ejemplo, UDP), se pierden los datos sobrantes. Para UDP si el paquete recibido no contiene datos (vacíos), el valor devuelto de la función recvfrom es cero.

Si el parámetro from es distinto de cero y el socket no está orientado a la conexión (tipo SOCK_DGRAM por ejemplo), la dirección de red del mismo nivel que envió los datos se copia en la estructura sockaddr correspondiente. El valor al que apunta fromlen se inicializa al tamaño de esta estructura y se modifica, a cambio, para indicar el tamaño real de la dirección almacenada en la estructura sockaddr .

Si no hay datos entrantes disponibles en el socket, la función recvfrom bloquea y espera a que los datos lleguen según las reglas de bloqueo definidas para WSARecv con la marca MSG_PARTIAL no establecida a menos que el socket no se bloquee. En este caso, se devuelve un valor de SOCKET_ERROR con el código de error establecido en WSAEWOULDBLOCK. La selección, WSAAsyncSelect o WSAEventSelect se puede usar para determinar cuándo llegan más datos.

Si el socket está orientado a la conexión y el lado remoto ha cerrado la conexión correctamente, la llamada a recvfrom se completará inmediatamente con cero bytes recibidos. Si se ha restablecido la conexión , se producirá un error WSAECONNRESET.

El parámetro flags se puede usar para influir en el comportamiento de la invocación de función más allá de las opciones especificadas para el socket asociado. La semántica de esta función viene determinada por las opciones de socket y el parámetro flags . Este último se construye mediante el operador OR bit a bit con cualquiera de los valores siguientes.

Código de ejemplo

#ifndef UNICODE
#define UNICODE
#endif

#define WIN32_LEAN_AND_MEAN

#include <winsock2.h>
#include <Ws2tcpip.h>
#include <stdio.h>

// Link with ws2_32.lib
#pragma comment(lib, "Ws2_32.lib")

int main()
{

    int iResult = 0;

    WSADATA wsaData;

    SOCKET RecvSocket;
    struct sockaddr_in RecvAddr;

    unsigned short Port = 27015;

    char RecvBuf[1024];
    int BufLen = 1024;

    struct sockaddr_in SenderAddr;
    int SenderAddrSize = sizeof (SenderAddr);

    //-----------------------------------------------
    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2, 2), &wsaData);
    if (iResult != NO_ERROR) {
        wprintf(L"WSAStartup failed with error %d\n", iResult);
        return 1;
    }
    //-----------------------------------------------
    // Create a receiver socket to receive datagrams
    RecvSocket = socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP);
    if (RecvSocket == INVALID_SOCKET) {
        wprintf(L"socket failed with error %d\n", WSAGetLastError());
        return 1;
    }
    //-----------------------------------------------
    // Bind the socket to any address and the specified port.
    RecvAddr.sin_family = AF_INET;
    RecvAddr.sin_port = htons(Port);
    RecvAddr.sin_addr.s_addr = htonl(INADDR_ANY);

    iResult = bind(RecvSocket, (SOCKADDR *) & RecvAddr, sizeof (RecvAddr));
    if (iResult != 0) {
        wprintf(L"bind failed with error %d\n", WSAGetLastError());
        return 1;
    }
    //-----------------------------------------------
    // Call the recvfrom function to receive datagrams
    // on the bound socket.
    wprintf(L"Receiving datagrams...\n");
    iResult = recvfrom(RecvSocket,
                       RecvBuf, BufLen, 0, (SOCKADDR *) & SenderAddr, &SenderAddrSize);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"recvfrom failed with error %d\n", WSAGetLastError());
    }
 
    //-----------------------------------------------
    // Close the socket when finished receiving datagrams
    wprintf(L"Finished receiving. Closing socket.\n");
    iResult = closesocket(RecvSocket);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"closesocket failed with error %d\n", WSAGetLastError());
        return 1;
    }

    //-----------------------------------------------
    // Clean up and exit.
    wprintf(L"Exiting.\n");
    WSACleanup();
    return 0;
}

Windows Phone 8: esta función es compatible con las aplicaciones de Windows Phone Store en Windows Phone 8 y versiones posteriores.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Consulte también

WSAAsyncSelect

WSAEventSelect

Funciones winsock

Referencia de Winsock

recv

enviar

sockaddr

socket