如果未发生错误,
则 send
将返回发送的总字节数,该字节数可能小于
在 len
参数中请求发送的数量。 否则,将返回值 SOCKET_ERROR,并且可以通过调用
WSAGetLastError
检索特定的错误代码。
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
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");
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。
必须显式包含 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 应用商店应用支持此函数。