UDP协议的两个主要方法sendto和recvfrom详解

UDP协议的两个主要方法sendto和recvfrom详解

(2010-04-27 10:50:38)


转载▼

标签： socket udp

分类：socket

sendto()

简述：   向一指定目的地发送数据。   #include<winsock.h>   int PASCAL FARsendto( SOCKET s, const char FAR* buf, int len, int flags,   const structsockaddr 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()获取相应错误代码。   recvfrom() 简述：   接收一个数据报并保存源地址。   #include<winsock.h>   int PASCAL FARrecvfrom( SOCKET s, char FAR* buf, int len, int flags,   struct sockaddrFAR* from, int FAR* fromlen);   s：标识一个已连接套接口的描述字。   buf：接收数据缓冲区。   len：缓冲区长度。   flags：调用操作方式。   from：（可选）指针，指向装有源地址的缓冲区。   fromlen：（可选）指针，指向from缓冲区长度值。 注释：   本函数由于从（已连接）套接口上接收数据，并捕获数据发送源的地址。   对于SOCK_STREAM类型的套接口，最多可接收缓冲区大小个数据。如果套接口被设置为线内接收带外数据（选项为SO_OOBINLINE），且有带外数据未读入，则返回带外数据。应用程序可通过调用ioctlsocket()的SOCATMARK命令来确定是否有带外数据待读入。对于SOCK_STREAM类型套接口，忽略from和fromlen参数。   对于数据报类套接口，队列中第一个数据报中的数据被解包，但最多不超过缓冲区的大小。如果数据报大于缓冲区，那么缓冲区中只有数据报的前面部分，其他的数据都丢失了，并且recvfrom()函数返回WSAEMSGSIZE错误。   若from非零，且套接口为SOCK_DGRAM类型，则发送数据源的地址被复制到相应的sockaddr结构中。fromlen所指向的值初始化时为这个结构的大小，当调用返回时按实际地址所占的空间进行修改。   如果没有数据待读，那么除非是非阻塞模式，不然的话套接口将一直等待数据的到来，此时将返回SOCKET_ERROR错误，错误代码是WSAEWOULDBLOCK。用select()或WSAAsynSelect()可以获知何时数据到达。   如果套接口为SOCK_STREAM类型，并且远端“优雅”地中止了连接，那么recvfrom()一个数据也不读取，立即返回。如果立即被强制中止，那么recv()将以WSAECONNRESET错误失败返回。   在套接口的所设选项之上，还可用标志位flag来影响函数的执行方式。也就是说，本函数的语义既取决于套接口选项，也取决于标志位参数。标志位可取下列值：   值 意义   MSG_PEEK查看当前数据。数据将被复制到缓冲区中，但并不从输入队列中删除。   MSG_OOB处理带外数据（参见2.2.3节具体讨论）。    返回值：   若无错误发生，recvfrom()返回读入的字节数。如果连接已中止，返回0。否则的话，返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()获取相应错误代码。

错误代码：

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

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

  WSAEFAULT：fromlen参数非法；from缓冲区大小无法装入端地址。

  WSAEINTR：阻塞进程被WSACancelBlockingCall()取消。

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

  WSAEINVAL：套接口未用bind()进行捆绑。

  WSAENOTCONN：套接口未连接（仅适用于SOCK_STREAM类型）。

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

  WSAEOPNOTSUPP：指定了MSG_OOB，但套接口不是SOCK_STREAM类型的。

  WSAESHUTDOWN：套接口已被关闭。当一个套接口以0或2的how参数调用shutdown()关闭后，无法再用recv()接收数据。

  WSAEWOULDBLOCK：套接口标识为非阻塞模式，但接收操作会产生阻塞。

  WSAEMSGSIZE：数据报太大无法全部装入缓冲区，故被剪切。

  WSAECONNABORTED：由于超时或其他原因，虚电路失效。

  WSAECONNRESET：远端强制中止了虚电路。