简述

概述

返回值

错误代码

简述

简述：从一个套接口接收数据。

#include <winsock2.h>

int WSAAPI WSARecv ( SOCKET s, LPWSABUF lpBuffers,

DWORD dwBufferCount, LPDWORD lpNumberOfBytesRecvd,

LPINT lpFlags, LPWSAOVERLAPPED lpOverlapped,

LPWSAOVERLAPPED_COMPLETION_ROUTINE

lpCompletionRoutine );

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

lpBuffers：一个指向WSABUF结构数组的指针。每一个WSABUF结构包含一个缓冲区的指针和缓冲区的长度。

dwBufferCount：lpBuffers数组中WSABUF结构的数目。

lpNumberOfBytesRecvd：如果接收操作立即结束，一个指向本调用所接收的字节数的指针。

lpFlags：一个指向标志位的指针。

lpOverlapped：一个指向WSAOVERLAPPED结构的指针（对于非重叠套接口则忽略）。

lpCompletionRoutine：一个指向接收操作结束后调用的例程的指针（对于非重叠套接口则忽略）。

概述

WSARecv

在重叠模型中，接收数据就要靠它了，它的参数也比recv要多，因为要用到重叠结构嘛，它是这样定义的：

int WSARecv(

SOCKET s, // 当然是投递这个操作的套接字

LPWSABUF lpBuffers, // 接收缓冲区，与Recv函数不同

// 这里需要一个由WSABUF结构构成的数组

DWORD dwBufferCount, // 数组中WSABUF结构的数量

LPDWORD lpNumberOfBytesRecvd, // 如果接收操作立即完成，这里会返回函数调用所接收到的字节数

LPDWORD lpFlags, // 说来话长了，我们这里设置为0 即可

LPWSAOVERLAPPED lpOverlapped, // “绑定”的重叠结构 LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine // 完成例程中将会用到的参数，我们这里设置为 NULL

);

返回值：

WSA_IO_PENDING ： 最常见的返回值，这是说明我们的WSARecv操作成功了，但是I/O操作还没有完成，所以我们就需要绑定一个事件来通知我们操作何时完成

返回值

：

若无错误发生且接收操作立即完成，则WSARecv()函数返回0，请注意在这种情况下完成指示（启动指定的完成例程或设置一个事件对象）将早已发生。否则的话，将返回SOCKET_ERROR错误，应用程序可通过WSAGetLastError()来获取相应的错误代码。错误代码WSA_IO_PENDING表示重叠操作成功启动，过后将有完成指示。任何其他的错误表示重叠操作未能成功地启动，以后也不会有完成指示。

如果设置了MSG_INTERRUPT标志，则返回值的含义变化。零表示成功，具体含义同上。否则的话，返回值直接包含如下所示的错误代码。由于中断环境中无法调用WSAGetLastError()，故是必需的。请注意仅适用于Win16环境，仅适用于PROTOCOL_INFO结构中设置了XP1_INTERRUPT位的协议。

错误代码

：

WSANOTINITIALISED 在调用本API之前应成功调用WSAStartup()。

WSAENETDOWN 网络子系统失效。

WSAENOTCONN 套接口未连接。

WSAEINTR 通过WSACancelBlockingCall()函数取消（阻塞）调用。

WSAEINPROGRESS 一个阻塞的WinSock调用正在进行中，或者服务提供者仍在处理一个回调函数

WSAENETRESET 由于远端的复位造成连接的中止。

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

WSAEOPNOTSUPP 设置了MSG_OOB，但是该套接口不是诸如SOCK_STREAM流类型的，与套接口相关的通讯域不支持带外数据，或者套接口是单向的，只支持发送操作。

WSAESHUTDOWN 套接口已经关闭；一个套接口以SD_RECEIVE或 SD_BOTH的how参数shutdown()后，无法进行WSARecv()调用。

WSAEWOULDBLOCK 重叠套接口：太多重叠的输入/输出请求。非重叠套接口：套接口被标志为非阻塞，但是操作不能立即完成。

WSAEINVAL 套接口未用bind()捆绑，或者套接口未用重叠标志创建。

WSAECONNABORTED 由于超时或其他错误导致虚电路中止。

WSAECONNRESET 虚电路被远端复位。

WSAEDISCON 远端优雅的结束了连接。

WSA_IO_PENDING 成功启动一个重叠操作，过后将有完成指示。

另请参阅： WSACloseEvent(),WSACreateEvent(),WSAGetOverlappedResult(), WSASocket(),WSAWaitForMultipleEvents()