重叠(Overlapped)I/O模型----重叠I/O函数----传输数据函数WSASend()

 WSASend()
简述：在一个已连接的套接口上发送数据。

#include <winsock2.h>

int WSAAPI WSASend (
    SOCKET s,
    LPWSABUF lpBuffers,
    DWORD dwBufferCount,
    LPDWORD lpNumberOfBytesSent,
    int iFlags,
    LPWSAOVERLAPPED lpOverlapped,
    LPWSAOVERLAPPED_COMPLETION_ROUTINE lpCompletionRoutine
);

s：标识一个已连接套接口的描述字。
lpBuffers：一个指向WSABUF结构数组的指针。每个WSABUF结构包含缓冲区的指针和缓冲区的大小。
dwBufferCount：lpBuffers数组中WSABUF结构的数目。
lpNumberOfBytesSent：如果发送操作立即完成，则为一个指向所发送数据字节数的指针。
iFlags：标志位。
lpOverlapped：指向WSAOVERLAPPED结构的指针（对于非重叠套接口则忽略）。
lpCompletionRoutine：一个指向发送操作完成后调用的完成例程的指针。完成例程是一个自定义函数，I/O操作完成后，Winsock便去调用它。这种方法很少使用，将lpCompletionRoutine设为NULL即可（对于非重叠套接口则忽略）。

返回值：
  若无错误发生且发送操作立即完成，则WSASend()函数返回所发送的字节数。（注意该数目可能小于len参数所指定的值）。如果连接结束，则返回0。请注意在这种情况下完成指示（启动指定的完成例程或设置一个事件对象）将早已发生。否则的话，将返回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参数并不是用户地址空间的一个有效部分。
WSAENETRESET                        由于远端复位造成连接的中止。
WSAENOBUFS                        WinSock提供者报告一个缓冲区死锁。
WSAENOTCONN                        套接口未连接。
WSAENOTSOCK                        描述字不是一个套接口。
WSAEOPNOTSUPP                设置了MSG_OOB，但是该套接口不是诸如SOCK_STREAM流类型的，与套接口相关的通讯域不支持带外数据，或者套接口是单向的，只支持接收操作。
WSAESHUTDOWN                套接口已经关闭；一个套接口以SD_SEND或SD _BOTH的how参数shutdown()后，无法进行WSASend()调用。
WSAEWOULDBLOCK                太多的重叠输入/输出操作。
WSAEMSGSIZE                        套接口是面向消息的，但是消息大于底层传送的最大值。
WSAEINVAL                                套接口未用bind()捆绑，或者套接口未用重叠标志位创建。
WSAECONNABORTED        由于超时或其他错误导致虚电路中止。
WSAECONNRESET                虚电路被远端复位。
WSA_IO_PENDING                成功启动重叠操作，过后将有完成指示。