WSARecvFrom()

int WSARecvFrom ( SOCKET s , LPWSABUF lpBuffers , DWORD dwBufferCount , LPDWORD lpNumberOfBytesRecvd , LPDWORD lpFlags , struct sockaddr FAR * lpFrom , LPINT lpFromlen , LPWSAOVERLAPPED lpOverlapped , LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionROUTINE );

 

简述：接收一个数据报并保存源地址。

　　#include <winsock2.h>

　　int  WSARecvFrom ( SOCKET s, LPWSABUF lpBuffers, DWORD dwBufferCount,

LPDWORD lpNumberOfBytesRecvd, LPDWORD lpFlags, LPVOID lpFrom, LPINT lpFromlen, LPWSAOVERLAPPED lpOverlapped, LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine );

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

　　lpBuffers：[in,out]一个指向WSABUF结构数组的指针。每个WSABUF结构包含缓冲区的指针和缓冲区的大小 。[需要初始化，WSABUF结构体中含有两个成员—指针和长度]

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

　　lpNumberOfBytesRecvd：[out]如果接收操作立即完成，则为一个指向所接收数据字节数的指针 。【需要定义一个变量接受存放数据的指针】

　　lpFlags：[in,out]一个指向套接字标志位的指针，会影响套接字的行为特性 。【需要初始化】

 

　　lpFrom：[out]（可选）指针，指向重叠操作完成后存放源地址的缓冲区。

　　lpFromlen：[in,out]指向from缓冲区大小的指针，仅当指定了lpFrom才需要。

 

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

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

　　返回值：

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

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

　　错误代码：

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

　　WSAENETDOWN                        网络子系统失效。

　　WSAEFAULT                                lpFromlen参数非法；lpFrom缓冲区太小，无法容纳远端地址。

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

　　WSAEINPROGRESS                一个阻塞的WinSock调用正在进行中，或者服务提供者仍在处理一个回调函数WSAEINVAL                                套接口未用bind()捆绑，或者套接口未用重叠标志创建。

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

　　WSAENOTCONN                        套接口未连接。（仅适用于面向连接的套接口）。

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

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

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

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

　　WSAEMSGSIZE                        消息太大无法全部装入指定的缓冲区，故被修剪。

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

　　WSAECONNRESET                虚电路被远端复位。

　　WSAEDISCON                        远端优雅地中止了连接。

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