#include

  int PASCAL FAR recvfrom( SOCKET s, char FAR* buf, int len, int flags,  struct sockaddr FAR* 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()获取相应错误代码。