WSASendTo()

王朝百科·作者佚名  2010-01-05  
宽屏版  字体: |||超大  

简述:向指定地址发送数据,可能的话使用重叠输入/输出操作。

#include <winsock2.h>

int WSAAPI WSASendTo ( SOCKET s, LPWSABUF

lpBuffers, DWORD dwBufferCount, LPDWORD

lpNumberOfBytesSent, int iFlags, LPVOID lpTo, int

iToLen, LPWSAOVERLAPPED lpOverlapped,

LPWSAOVERLAPPED_COMPLETION_ROUTINE

lpCompletionRoutine );

s:用于标识一个已连接的套接口,该套接口以WSA_FLAG_OVERLAPPED标志调用WSASocket()创建。

lpBuffers:一个指向WSABUF结构数组的指针。每个WSABUF结构包含缓冲区的指针和缓冲区的大小。

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

lpNumberOfBytesSent:如果发送操作立即完成,则为一个指向所发送数据字节数的指针。

iFlags:标志位。

lpTo:(可选)指针,指向目标套接口的地址。

lpTolen:lpTo中地址的大小。

lpOverlapped:指向WSAOVERLAPPED结构的指针(对于非重叠套接口则忽略)。

lpCompletionRoutine:一个指向发送操作完成后调用的完成例程的指针。(对于非重叠套接口则忽略)。

返回值:

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

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

错误代码:

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

WSAENETDOWN 网络子系统失效。

WSAEACCES 请求的地址为广播地址,但未设置相应的标志位。

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

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

WSAEFAULT lpBuffer或lpTo参数不是用户地址空间的一部分;或者lpTo参数太小(小于sockaddr结构的大小)。

WSAENETRESET 远端主机复位造成连接的中止。

WSAENOBUFS WinSock提供者报告了一个缓冲区死锁。

WSAENOTCONN 套接口未连接(仅适用于面向连接的套接口)。

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

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

WSAESHUTDOWN 套接口已经关闭;一个套接口以SD_SEND或SD _BOTH的how参数shutdown()后,无法进行WSASendTo()调用。

WSAEWOULDBLOCK 太多重叠的输入/输出请求。

WSAEMSGSIZE 套接口是面向消息的,且消息大于底层传送所支持的最大长度。

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

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

WSAECONNRESET 虚电路被远端复位。

WSAEADDRNOTAVAIL 本地主机无法获取所指定的地址。

WSAEAFNOSUPPORT 指定地址族中的地址无法与本套接口一起使用。

WSAEDESTADDRREQ 需要目的地地址。

WSAENETUNREACH 当前无法从本主机联系网络。

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

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

 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
 
© 2005- 王朝百科 版权所有