vc之recv

编辑本段

简述：

　　从一个套接口接收数据。 　　#include <winsock.h> 　　int PASCAL FAR recv( SOCKET s, char FAR* buf, int len, int flags); 　　s：一个标识已连接套接口的描述字。 　　buf：用于接收数据的缓冲区。 　　len：缓冲区长度。 　　flags：指定调用方式。

编辑本段

注释：

　　本函数用于已连接的数据报或流式套接口s进行数据的接收。 　　对SOCK_STREAM类型的套接口来说，本函数将返回所有可用的信息，最大可达缓冲区的大小。如果套接口被设置为线内接收带外数据（选项为SO_OOBINLINE），且有带外数据未读入，则返回带外数据。应用程序可通过调用 ioctlsocket()的SOCATMARK命令来确定是否有带外数据待读入。 　　对于数据报类套接口，队列中第一个数据报中的数据被解包，但最多不超过缓冲区的大小。如果数据报大于缓冲区，那么缓冲区中只有数据报的前面部分，其他的数据都丢失了，并且recv()函数返回WSAEMSGSIZE错误。如果没有数据待读，那么除非是非阻塞模式，不然的话套接口将一直等待数据的到来，此时将返回SOCKET_ERROR错误，错误代码是WSAEWOULDBLOCK。用 select()或WSAAsynSelect()可以获知何时数据到达。 　　如果套接口为SOCK_STREAM类型，并且远端“优雅”地中止了连接，那么recv()一个数据也不读取，立即返回。如果立即被强制中止，那么recv()将以WSAECONNRESET错误失败返回。在套接口的所设选项之上，还可用标志位flag来影响函数的执行方式。也就是说，本函数的语义既取决于套接口选项，也取决于标志位参数。标志位可取下列值： 　　值 意义 　　MSG_PEEK查看当前数据。数据将被复制到缓冲区中，但并不从输入队列中删除。 　　MSG_OOB 处理带外数据（参见2.2.3节具体讨论）。 　　返回值： 　　若无错误发生，recv()返回读入的字节数。如果连接已中止，返回0。否则的话，返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()获取相应错误代码。 　　错误代码： 　　WSANOTINITIALISED：在使用此API之前应首先成功地调用WSAStartup()。 　　WSAENETDOWN：WINDOWS套接口实现检测到网络子系统失效。 　　WSAENOTCONN：套接口未连接。 　　WSAEINTR：阻塞进程被WSACancelBlockingCall()取消。 　　WSAEINPROGRESS：一个阻塞的WINDOWS套接口调用正在运行中。 　　WSAENOTSOCK：描述字不是一个套接口。 　　WSAEOPNOTSUPP：指定了MSG_OOB，但套接口不是SOCK_STREAM类型的。 　　WSAESHUTDOWN：套接口已被关闭。当一个套接口以0或2的how参数调用shutdown()关闭后，无法再用recv()接收数据。 　　WSAEWOULDBLOCK：套接口标识为非阻塞模式，但接收操作会产生阻塞。 　　WSAEMSGSIZE：数据报太大无法全部装入缓冲区，故被剪切。 　　WSAEINVAL：套接口未用bind()进行捆绑。 　　WSAECONNABORTED：由于超时或其他原因，虚电路失效。 　　WSAECONNRESET：远端强制中止了虚电路。 　　参见： 　　 recvfrom(), read(), recv(), send(), select(), WSAAsyncSelect(), socket().