Funzione recv (winsock.h)

La funzione recv riceve i dati da un socket connesso o da un socket senza connessione associato.

Sintassi

int recv(
  [in]  SOCKET s,
  [out] char   *buf,
  [in]  int    len,
  [in]  int    flags
);

Parametri

[in] s

Descrittore che identifica un socket connesso.

[out] buf

Puntatore al buffer per ricevere i dati in ingresso.

[in] len

Lunghezza, in byte, del buffer a cui punta il parametro buf .

[in] flags

Set di flag che influisce sul comportamento di questa funzione. Vedere la sezione Note riportata di seguito. Per informazioni dettagliate sul valore possibile per questo parametro, vedere la sezione Osservazioni.

Valore restituito

Se non si verifica alcun errore, recv restituisce il numero di byte ricevuti e il buffer a cui punta il parametro buf conterrà i dati ricevuti. Se la connessione è stata chiusa normalmente, il valore restituito è zero.

In caso contrario, viene restituito un valore di SOCKET_ERROR e è possibile recuperare un codice di errore specifico chiamando WSAGetLastError.

Commenti

La funzione recv viene usata per leggere i dati in ingresso su socket orientati alla connessione o socket senza connessione. Quando si usa un protocollo orientato alla connessione, i socket devono essere connessi prima di chiamare recv. Quando si usa un protocollo senza connessione, i socket devono essere associati prima di chiamare recv.

L'indirizzo locale del socket deve essere noto. Per le applicazioni server, usare una funzione di associazione esplicita o una funzione di accettazione implicita o WSAAccept . L'associazione esplicita è sconsigliata per le applicazioni client. Per le applicazioni client, il socket può diventare associato in modo implicito a un indirizzo locale usando connect, WSAConnect, sendto, WSASendTo o WSAJoinLeaf.

Per i socket connessi o senza connessione, la funzione recv limita gli indirizzi da cui vengono accettati i messaggi ricevuti. La funzione restituisce solo messaggi dall'indirizzo remoto specificato nella connessione. I messaggi provenienti da altri indirizzi vengono eliminati in modo invisibile all'utente.

Per i socket orientati alla connessione (ad esempio, tipo SOCK_STREAM), la chiamata a recv restituirà la quantità di dati attualmente disponibile, fino alle dimensioni del buffer specificato. Se il socket è stato configurato per la ricezione in linea dei dati OOB (opzione socket SO_OOBINLINE) e i dati OOB non sono ancora letti, verranno restituiti solo i dati OOB. L'applicazione può usare il comando Ioctlsocket o WSAIoctlSIOCATMARK per determinare se devono essere letti altri dati OOB.

Per i socket senza connessione (tipo SOCK_DGRAM o altri socket orientati ai messaggi), i dati vengono estratti dal primo datagramma accodato (messaggio) dall'indirizzo di destinazione specificato dalla funzione connect .

Se il datagram o il messaggio è maggiore del buffer specificato, il buffer viene riempito con la prima parte del datagram e viene generato l'errore WSAEMSGSIZE. Per i protocolli inaffidabili (ad esempio UDP) i dati in eccesso andranno persi; per i protocolli affidabili, i dati vengono conservati dal provider di servizi fino a quando non vengono letti correttamente chiamando recv con un buffer sufficientemente grande.

Se nel socket non sono disponibili dati in ingresso, il recv chiama i blocchi e attende l'arrivo dei dati in base alle regole di blocco definite per WSARecv con il flag MSG_PARTIAL non impostato a meno che il socket non si blocchi. In questo caso, viene restituito un valore di SOCKET_ERROR con il codice di errore impostato su WSAEWOULDBLOCK. Le funzioni select, WSAAsyncSelect o WSAEventSelect possono essere usate per determinare quando arrivano più dati.

Se il socket è orientato alla connessione e il lato remoto ha arrestato correttamente la connessione e tutti i dati sono stati ricevuti, un recv verrà completato immediatamente con zero byte ricevuti. Se la connessione è stata reimpostata, un recv avrà esito negativo con l'errore WSAECONNRESET.

Il parametro flags può essere usato per influenzare il comportamento della chiamata di funzione oltre le opzioni specificate per il socket associato. La semantica di questa funzione è determinata dalle opzioni socket e dal parametro flags . Il valore possibile del parametro flags viene costruito usando l'operatore OR bit per bit con uno dei valori seguenti.

Codice di esempio

#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")

#define DEFAULT_BUFLEN 512
#define DEFAULT_PORT "27015"

int __cdecl main() {

    //----------------------
    // Declare and initialize variables.
    WSADATA wsaData;
    int iResult;

    SOCKET ConnectSocket = INVALID_SOCKET;
    struct sockaddr_in clientService; 

    char *sendbuf = "this is a test";
    char recvbuf[DEFAULT_BUFLEN];
    int recvbuflen = DEFAULT_BUFLEN;
  
    //----------------------
    // Initialize Winsock
    iResult = WSAStartup(MAKEWORD(2,2), &wsaData);
    if (iResult != NO_ERROR) {
      printf("WSAStartup failed: %d\n", iResult);
      return 1;
    }

    //----------------------
    // Create a SOCKET for connecting to server
    ConnectSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ConnectSocket == INVALID_SOCKET) {
        printf("Error at socket(): %ld\n", WSAGetLastError() );
        WSACleanup();
        return 1;
    }

    //----------------------
    // The sockaddr_in structure specifies the address family,
    // IP address, and port of the server to be connected to.
    clientService.sin_family = AF_INET;
    clientService.sin_addr.s_addr = inet_addr( "127.0.0.1" );
    clientService.sin_port = htons( 27015 );

    //----------------------
    // Connect to server.
    iResult = connect( ConnectSocket, (SOCKADDR*) &clientService, sizeof(clientService) );
    if ( iResult == SOCKET_ERROR) {
        closesocket (ConnectSocket);
        printf("Unable to connect to server: %ld\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    // Send an initial buffer
    iResult = send( ConnectSocket, sendbuf, (int)strlen(sendbuf), 0 );
    if (iResult == SOCKET_ERROR) {
        printf("send failed: %d\n", WSAGetLastError());
        closesocket(ConnectSocket);
        WSACleanup();
        return 1;
    }

    printf("Bytes Sent: %ld\n", iResult);

    // shutdown the connection since no more data will be sent
    iResult = shutdown(ConnectSocket, SD_SEND);
    if (iResult == SOCKET_ERROR) {
        printf("shutdown failed: %d\n", WSAGetLastError());
        closesocket(ConnectSocket);
        WSACleanup();
        return 1;
    }

    // Receive until the peer closes the connection
    do {

        iResult = recv(ConnectSocket, recvbuf, recvbuflen, 0);
        if ( iResult > 0 )
            printf("Bytes received: %d\n", iResult);
        else if ( iResult == 0 )
            printf("Connection closed\n");
        else
            printf("recv failed: %d\n", WSAGetLastError());

    } while( iResult > 0 );

    // cleanup
    closesocket(ConnectSocket);
    WSACleanup();

    return 0;
}

Codice di esempio

Windows Phone 8: questa funzione è supportata per le app dello Store di Windows Phone in Windows Phone 8 e versioni successive.

Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.

Requisiti

Vedi anche

WSAAsyncSelect

WSARecv

WSARecvEx

Funzioni Winsock

Informazioni di riferimento su Winsock

recvfrom

select

send

Socket