| 词条 | WSASendTo() |
| 释义 | § 简述 向指定地址发送数据，可能的话使用重叠输入/输出操作。 #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() |
| 随便看 |
百科全书收录594082条中文百科知识，基本涵盖了大多数领域的百科知识，是一部内容开放、自由的电子版百科全书。