简述：

 

  向一指定目的地发送数据。

 

  #include<winsock.h>

 

  int PASCAL FAR sendto( SOCKETs, const char FAR* buf, int len, int flags,

 

  const struct sockaddr FAR* to,int tolen);

 

  s：一个标识套接口的描述字。

 

  buf：包含待发送数据的缓冲区。

 

  len：buf缓冲区中数据的长度。

 

  flags：调用方式标志位。

 

  to：（可选）指针，指向目的套接口的地址。

 

  tolen：to所指地址的长度。

注释：

 

  　sendto()适用于已连接的数据报或流式套接口发送数据。对于数据报类套接口，必需注意发送数据长度不应超过通讯子网的IP包最大长度。IP包最大长度在WSAStartup()调用返回的WSAData的iMaxUdpDg元素中。如果数据太长无法自动通过下层协议，则返回WSAEMSGSIZE错误，数据不会被发送。

 

  　请注意成功地完成sendto()调用并不意味着数据传送到达。

 

　  sendto()函数主要用于SOCK_DGRAM类型套接口向to参数指定端的套接口发送数据报。对于SOCK_STREAM类型套接口，to和tolen参数被忽略；这种情况下sendto()等价于send()。

 

  　为了发送广播数据（仅适用于SOCK_DGRAM），in参数所含地址应该把特定的IP地址INADDR_BROADCAST（winsock.h中有定义）和终端地址结合起来构造。通常建议一个广播数据报的大小不要大到以致产生碎片，也就是说数据报的数据部分（包括头）不超过512字节。

 

  　如果传送系统的缓冲区空间不够保存需传送的数据，除非套接口处于非阻塞I/O方式，否则sendto()将阻塞。对于非阻塞SOCK_STREAM类型的套接口，实际写的数据数目可能在1到所需大小之间，其值取决于本地和远端主机的缓冲区大小。可用select()调用来确定何时能够进一步发送数据。

标志位：

      在相关套接口的选项之上，还可通过标志位flag来影响函数的执行方式。也就是说，本函数的语义既取决于套接口的选项也取决于标志位。后者由以下一些值组成：


MSG_DONTROUTE 


  指明数据不选径。一个WINDOWS套接口供应商可以忽略此标志；参见2.4节中关于SO_DONTROUTE的讨论。
MSG_OOB        发送带外数据（仅适用于SO_STREAM；参见2.2.3节）。   

返回值：

 

  若无错误发生，send()返回所发送数据的总数（请注意这个数字可能小于len中所规定的大小）。否则的话，返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()获取相应错误代码。



错误代码：

 

  WSANOTINITIALISED：在使用此API之前应首先成功地调用WSAStartup()。

 

  WSAENETDOWN：WINDOWS套接口实现检测到网络子系统失效。

 

  WSAEACESS：要求地址为广播地址，但相关标志未能正确设置。

 

  WSAEINTR：通过一个WSACancelBlockingCall()来取消一个（阻塞的）调用。

 

  WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。

 

  WSAEFAULT：buf或to参数不是用户地址空间的一部分，或to参数太小（小于sockaddr结构大小）。

 

  WSAENETRESET：由于WINDOWS套接口实现放弃了连接，故该连接必需被复位。

 

  WSAENOBUFS：WINDOWS套接口实现报告一个缓冲区死锁。

 

  WSAENOTCONN：套接口未被连接。

 

  WSAENOTSOCK：描述字不是一个套接口。

 

  WSAEOPNOTSUPP：已设置了MSG_OOB，但套接口非SOCK_STREAM类型。

 

  WSAESHUTDOWN：套接口已被关闭。一个套接口以1或2的how参数调用shutdown()关闭后，无法再用sned()函数。

 

  WSAEWOULDBLOCK：套接口被标志为非阻塞，但该调用会产生阻塞。

 

  WSAEMSGSIZE：套接口为SOCK_DGRAM类型，且数据报大于WINDOWS套接口实现所支持的最大值。

 

  WSAECONNABORTED：由于超时或其他原因引起虚电路的中断。

 

  WSAECONNRESET：虚电路被远端复位。

 

  WSAEADDRNOTAVAIL：所指地址无法从本地主机获得。

 

  WSAEAFNOSUPPORT：所指定地址族中地址无法与本套接口一切使用。

 

  WSAEDESADDRREQ：需要目的地址。

 

  WSAENETUNREACH：当前无法从本主机联上网络。


参见：


 

  recv(), recvfrom(), socket(),send(), WSAStartup().