recv 函式 (winsock2.h)

recv 函式會從連接的套接字或系結的無連接套接字接收數據。

語法

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

參數

[in] s

識別已連接套接字的描述項。

[out] buf

要接收傳入數據的緩衝區指標。

[in] len

buf 參數所指向之緩衝區的長度，以位元組為單位。

[in] flags

一組旗標，會影響此函式的行為。 請參閱下面的＜備註＞。 如需此參數可能值的詳細資訊，請參閱一節。

傳回值

如果沒有發生錯誤， recv 會傳回收到的位元組數目，而 buf 參數所指向的緩衝區將包含此接收的數據。 如果連接已正常關閉，則傳回值為零。

否則，會傳回SOCKET_ERROR的值，並呼叫 WSAGetLastError 來擷取特定的錯誤碼。

備註

recv 函式可用來讀取連線導向套接字或無連接套接字上的傳入數據。 使用連線導向通訊協定時，必須先連接套接字，才能呼叫 recv。 使用無連線通訊協定時，必須在呼叫 recv 之前系結套接字。

必須知道套接字的本機位址。 對於伺服器應用程式，請使用明確 系結 函式或隱含 接受 或 WSAAccept 函 式。 用戶端應用程式不建議使用明確系結。 針對用戶端應用程式，套接字可以使用 connect、 WSAConnect、 sendto、 WSASendTo 或 WSAJoinLeaf 隱含地系結至本機位址。

針對已連線或無連線的套接字， recv 函式會限制接受接收訊息的位址。 函式只會從連接中指定的遠端位址傳回訊息。 其他地址的訊息 (以無訊息方式) 捨棄。

例如，對於連線導向套接字 (類型SOCK_STREAM例如) ，呼叫 recv 會傳回目前可用的數據量，最多可傳回指定的緩衝區大小。 如果套接字已針對 OOB 數據的內嵌接收設定， (套接字選項SO_OOBINLINE) 且 OOB 數據尚未讀取，則只會傳回 OOB 數據。 應用程式可以使用 ioctlsocket 或 WSAIoctlSIOCATMARK 命令來判斷是否要讀取任何 OOB 資料。

對於無連線套接字 (類型SOCK_DGRAM或其他訊息導向套接字) ，數據會從 連線 函式指定的目的地位址擷取第一個加入佇列的數據報 (訊息) 。

如果數據報或訊息大於指定的緩衝區，則緩衝區會填入數據報的第一個部分，而 recv 會產生錯誤 WSAEMSGSIZE。 例如，對於不可靠的通訊協定 (，UDP) 多餘的數據遺失;對於可靠的通訊協議，數據會由服務提供者保留，直到呼叫具有足夠大緩衝區 的 recv 成功讀取為止。

如果套接字上沒有可用的傳入數據， recv 呼叫會封鎖並等候數據根據 WSARecv 所定義的封鎖規則來抵達，除非套接字未封鎖，否則不會設定 MSG_PARTIAL 旗標。 在此情況下，會傳回 SOCKET_ERROR的值，並將錯誤碼設定為 WSAEWOULDBLOCK。 select、WSAAsyncSelect 或 WSAEventSelect 函式可用來判斷何時有更多數據送達。

如果套接字是面向連線，而且遠端端已正常關閉連線，而且已收到所有數據， 則 recv 會立即完成，並接收零個字節。 如果連線已重設， recv 將會失敗，並出現 WSAECONNRESET 錯誤。

flags 參數可用來影響函式調用的行為，超出為相關聯套接字指定的選項。 此函式的語意取決於套接字選項和 flags 參數。 flags 參數的可能值是使用位 OR 運算符搭配下列任何值來建構。

範例程序代碼

#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;
}

範例程序代碼

Windows Phone 8：Windows Phone Windows Phone 8 和更新版本上的市集應用程式支援此函式。

Windows 8.1 和 Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更新版本上的 Windows 市集應用程式支援此函式。

規格需求

另請參閱

WSAAsyncSelect

WSARecv

WSARecvEx

Winsock 函式

Winsock 參考

recvfrom

select

send

socket