send 函数 (winsock2.h)

send 函数在连接的套接字上发送数据。

语法

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

参数

[in] s

标识已连接套接字的描述符。

[in] buf

指向包含要传输的数据的缓冲区的指针。

[in] len

buf 参数指向的缓冲区中数据的长度（以字节为单位）。

[in] flags

一组指定调用方式的标志。 此参数是使用以下任一值的按位 OR 运算符构造的。

值	含义
MSG_DONTROUTE	：指定数据不应受到路由的约束。 Windows 套接字服务提供程序可以选择忽略此标志。
MSG_OOB	仅) (流式套接字（例如SOCK_STREAM）发送 OOB 数据。

返回值

如果未发生错误， send 将返回发送的总字节数，该字节数可能小于 在 len 参数中请求发送的字节数。 否则，将返回值 SOCKET_ERROR，并且可以通过调用 WSAGetLastError 来检索特定的错误代码。

错误代码	含义
WSANOTINITIALISED	在使用此函数之前，必须成功调用 WSAStartup 。
WSAENETDOWN	网络子系统失败。
WSAEACCES	：请求的地址是广播地址，但相应的标志未设置。 使用 SO_BROADCAST 套接字选项调用 setsockopt 以启用广播地址的使用。
WSAEINTR	阻止的 Windows 套接字 1.1 调用已通过 WSACancelBlockingCall 取消。
WSAEINPROGRESS	阻止 Windows Sockets 1.1 调用正在进行，或者服务提供程序仍在处理回调函数。
WSAEFAULT	buf 参数未完全包含在用户地址空间的有效部分。
WSAENETRESET	由于执行操作过程中保持活动状态的活动检测到故障，连接已经损坏。
WSAENOBUFS	未提供任何缓冲区空间。
WSAENOTCONN	套接字未连接。
WSAENOTSOCK	：描述符不是套接字。
WSAEOPNOTSUPP	MSG_OOB已指定，但套接字不是流样式（如类型SOCK_STREAM），与此套接字关联的通信域中不支持 OOB 数据，或者套接字是单向的，仅支持接收操作。
WSAESHUTDOWN	套接字已关闭;在调用 关闭 后，无法在套接字上发送 ， 并将 如何 设置为 SD_SEND 或 SD_BOTH。
WSAEWOULDBLOCK	：套接字标记为非阻止，请求的操作会进行阻止。
WSAEMSGSIZE	套接字面向消息，消息大于基础传输支持的最大大小。
WSAEHOSTUNREACH	此时无法从此主机访问远程主机。
WSAEINVAL	尚未 绑定套接字，或者指定了未知标志，或者为启用了 SO_OOBINLINE 的套接字指定了MSG_OOB。
WSAECONNABORTED	由于超时或其他故障，虚拟线路已终止。 因为套接字不可再用，应用程序应关闭套接字。
WSAECONNRESET	执行硬性或异常关闭的远程端重置了虚拟线路。 对于 UDP 套接字，远程主机无法传送以前发送的 UDP 数据报，并响应了“端口无法访问”ICMP 数据包。 因为套接字不可再用，应用程序应关闭套接字。
WSAETIMEDOUT	由于网络故障或另一端的系统在未通知的情况下出现故障，连接已断开。

注解

send 函数用于在连接的套接字上写入传出数据。

对于面向消息的套接字 (地址系列AF_INET 或 AF_INET6、 SOCK_DGRAM类型和 IPPROTO_UDP协议（例如) ），必须注意不要超过基础提供程序的最大数据包大小。 可以通过调用将 optname 参数设置为 SO_MAX_MSG_SIZE的 getsockopt 来获取提供程序的最大消息数据包大小，以检索 socket 选项的值。 如果数据太长，无法通过基础协议以原子方式传递，则返回错误 WSAEMSGSIZE ，并且不会传输任何数据。

发送函数的成功完成并不表示数据已成功传递并接收给收件人。 此函数仅指示已成功发送数据。

如果传输系统中没有可用于保存要传输的数据的缓冲区空间，除非套接字处于非阻止模式，否则 发送 将阻塞。 在面向非阻止流的套接字上，写入的字节数可以介于 1 和请求的长度之间，具体取决于客户端和服务器计算机上的缓冲区可用性。 select、WSAAsyncSelect 或 WSAEventSelect 函数可用于确定何时可以发送更多数据。

允许使用 len 参数为零调用 send，并且实现将被视为成功。 在这种情况下， send 将返回零作为有效值。 对于面向消息的套接字，将发送零长度传输数据报。

flags 参数可用于影响为关联套接字指定的选项之外的函数的行为。 send 函数的语义由之前在 s 参数中指定的套接字上设置的任何选项以及传递给 send 函数的 flags 参数确定。

调用 发送 的顺序也是缓冲区传输到传输层的顺序。 不应从不同的线程同时在同一个面向流的套接字上调用 send，因为某些 Winsock 提供程序可能会将大型发送请求拆分为多个传输，这可能会导致意外的数据从同一流导向套接字上的多个并发发送请求交错。

注意 发出阻止 Winsock 调用（如 send）时，Winsock 可能需要等待网络事件，然后才能完成调用。 在这种情况下，Winsock 执行可发出警报的等待， (在同一线程上计划的 APC) 异步过程调用可能会中断该等待。 在 APC 内发出另一个阻止 Winsock 调用，该调用中断了同一线程上正在进行的阻止 Winsock 调用将导致未定义的行为，并且 Winsock 客户端绝不能尝试。

 

示例代码

以下示例演示如何使用 send 函数。

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

#define DEFAULT_BUFLEN 512
#define DEFAULT_PORT 27015

int main() {

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

    SOCKET ConnectSocket = INVALID_SOCKET;
    struct sockaddr_in clientService; 

    int recvbuflen = DEFAULT_BUFLEN;
    char *sendbuf = "Client: sending data test";
    char recvbuf[DEFAULT_BUFLEN] = "";

    //----------------------
    // 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 SOCKET for connecting to server
    ConnectSocket = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);
    if (ConnectSocket == INVALID_SOCKET) {
        wprintf(L"socket failed with error: %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( DEFAULT_PORT );

    //----------------------
    // Connect to server.
    iResult = connect( ConnectSocket, (SOCKADDR*) &clientService, sizeof(clientService) );
    if (iResult == SOCKET_ERROR) {
        wprintf(L"connect failed with error: %d\n", WSAGetLastError() );
        closesocket(ConnectSocket);
        WSACleanup();
        return 1;
  }

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

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

    // shutdown the connection since no more data will be sent
    iResult = shutdown(ConnectSocket, SD_SEND);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"shutdown failed with error: %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 )
            wprintf(L"Bytes received: %d\n", iResult);
        else if ( iResult == 0 )
            wprintf(L"Connection closed\n");
        else
            wprintf(L"recv failed with error: %d\n", WSAGetLastError());

    } while( iResult > 0 );


    // close the socket
    iResult = closesocket(ConnectSocket);
    if (iResult == SOCKET_ERROR) {
        wprintf(L"close failed with error: %d\n", WSAGetLastError());
        WSACleanup();
        return 1;
    }

    WSACleanup();
    return 0;
}

示例代码

有关使用 send 函数的另一个示例，请参阅 入门 With Winsock。

IrDA 套接字说明

• 必须显式包含 Af_irda.h 头文件。

Windows Phone 8：Windows Phone 8 及更高版本上的 Windows Phone 应用商店应用支持此函数。

Windows 8.1和Windows Server 2012 R2：Windows 8.1、Windows Server 2012 R2 及更高版本的 Windows 应用商店应用支持此函数。

要求

要求	值
最低受支持的客户端	Windows 8.1、Windows Vista [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 | UWP 应用]
目标平台	Windows
标头	winsock2.h
Library	Ws2_32.lib
DLL	Ws2_32.dll

另请参阅

使用 Winsock 入门

WSAAsyncSelect

WSAEventSelect

Winsock 函数

Winsock 参考

recv

recvfrom

select

sendto

socket