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 成功启动一个重叠操作,过后将有完成指示。