7.html

WinSock编程规范及应用

</FONT><B><FONT FACE="黑体" LANG="ZH-CN" SIZE=5><P><A NAME="_Toc336626915"><A NAME="_Toc336792998"><A NAME="_Toc336793474"></FONT><FONT FACE="Arial" SIZE=5>7.9 WSAGetOverlappedResult()</A></A></A></P>
</B></FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3><P ALIGN="JUSTIFY">简述：返回指定套接口上一个重叠操作的结果。</P>
<P ALIGN="JUSTIFY"></P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">          #include &lt;winsock2.h&gt;</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">          BOOL WSAAPI WSAGetOverlappedResult( SOCKET s,</P>
<P ALIGN="JUSTIFY">          LPWSAOVERLAPPED lpOverlapped, LPDWORD</P>
<P ALIGN="JUSTIFY">          lpcbTransfer, BOOL fWait, LPDWORD lpdwFlags );</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">s</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：标识套接口。这就是调用重叠操作（</FONT><FONT SIZE=3>WSARecv()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>、</FONT><FONT SIZE=3> WSARecvFrom()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>、</FONT><FONT SIZE=3>WSASend()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>、</FONT><FONT SIZE=3>WSASendTo() </FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>或</FONT><FONT SIZE=3> WSAIoctl()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>）时指定的那个套接口。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">lpOverlapped</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：指向调用重叠操作时指定的</FONT><FONT SIZE=3>WSAOVERLAPPED</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>结构。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">lpcbTransfer</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：指向一个</FONT><FONT SIZE=3>32</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>位变量，该变量用于存放一个发送或接收操作实际传送的字节数，或</FONT><FONT SIZE=3>WSAIoctl()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>传送的字节数。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">fWait</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：指定函数是否等待挂起的重叠操作结束。若为真</FONT><FONT SIZE=3>TRUE</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>则函数在操作完成后才返回。若为假</FONT><FONT SIZE=3>FALSE</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>且函数挂起，则函数返回</FONT><FONT SIZE=3>FALSE</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>，</FONT><FONT SIZE=3>WSAGetLastError()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>函数返回</FONT><FONT SIZE=3>                    WSA_IO_INCOMPLETE</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">lpdwFlags</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：指向一个</FONT><FONT SIZE=3>32</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>位变量，该变量存放完成状态的附加标志位。如果重叠操作为</FONT><FONT SIZE=3>                    WSARecv()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>或</FONT><FONT SIZE=3>WSARecvFrom()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>，则本参数包含</FONT><FONT SIZE=3>lpFlags</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>参数所需的结果。</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">返回值：</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">  </FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>如果函数成功，则返回值为真</FONT><FONT SIZE=3>TRUE</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>。它意味着重叠操作已经完成，</FONT><FONT SIZE=3>lpcbTransfer</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>所指向的值已经被刷新。应用程序可调用</FONT><FONT SIZE=3>WSAGetLastError()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>来获取重叠操作的错误信息。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">  </FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>如果函数失败，则返回值为假</FONT><FONT SIZE=3>FALSE</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>。它意味着要么重叠操作未完成，要么由于一个或多个参数的错误导致无法决定完成状态。失败时，</FONT><FONT SIZE=3>lpcbTransfer</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>指向的值不会被刷新。应用程序可用</FONT><FONT SIZE=3>WSAGetLastError()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>来获取失败的原因。</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">错误代码：</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSANOTINITIALISED&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>在调用本</FONT><FONT SIZE=3>API</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>之前应成功调用</FONT><FONT SIZE=3>WSAStartup()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSAENETDOWN&#9;&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>网络子系统失效。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSAENOTSOCK &#9;&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>描述字不是一个套接口。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSA_INVALID_HANDLE&#9;WSAOVERLAPPED</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>结构的</FONT><FONT SIZE=3>hEvent</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>域未包含一个有效的事件对象句柄。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSA_INVALID_PARAMETER&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>有不可接受的参数。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSA_IO_INCOMPLETE&#9;fWait</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>假</FONT><FONT SIZE=3>FALSE</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>且输入</FONT><FONT SIZE=3>/</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>输出操作尚未完成。</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">另请参阅：</FONT><FONT SIZE=3>  WSACreateEvent(), WSAWaitForMultipleEvents(),WSARecv(), WSARecvFrom(), WSASend(), WSASendTo(),WSAConnect(), WSAAccept(), WSAIoctl().</P>
<P ALIGN="JUSTIFY"></P>
</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3><P ALIGN="JUSTIFY">　</P>
</FONT><B><FONT FACE="黑体" LANG="ZH-CN" SIZE=5><P><A NAME="_Toc336626916"><A NAME="_Toc336792999"><A NAME="_Toc336793475"></FONT><FONT FACE="Arial" SIZE=5>7.10 WSAGetQoSByName()</A></A></A></P>
</B></FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3><P ALIGN="JUSTIFY">简述：根据一个模板初始化</FONT><FONT SIZE=3>QOS</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>。</P>
<P ALIGN="JUSTIFY"></P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">          #include &lt;winsock2.h&gt;</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">          BOOL WSAAPI WSAGetQOSByName( SOCKET s, LPWSABUF</P>
<P ALIGN="JUSTIFY">          lpQOSName, LPQOS lpQOS);</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">s</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：一个标识套接口的描述字。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">lpQOSName</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：指定</FONT><FONT SIZE=3>QOS</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>模板的名字。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">lpQOS</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：指向待填充</FONT><FONT SIZE=3>QOS</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>结构的指针。</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">返回值：</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">  </FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>如果函数成功，返回真</FONT><FONT SIZE=3>TRUE</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>。如果函数失败，返回假</FONT><FONT SIZE=3>FALSE</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>。可调用</FONT><FONT SIZE=3>WSAGetLastError()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>来获取进一步的错误信息。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">          </P>
</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3><P ALIGN="JUSTIFY">错误代码：</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSANOTINITIALISED&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>在调用本</FONT><FONT SIZE=3>API</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>之前应成功调用</FONT><FONT SIZE=3>WSAStartup()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSAENETDOWN&#9;&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>网络子系统失效。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSAENOTSOCK&#9;&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>描述字不是一个套接口。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSAEFAULT&#9;&#9;&#9;&#9;lpQOS</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>参数不是用户地址空间的一个有效部分，或</FONT><FONT SIZE=3>lpQOS</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>的缓冲区太小。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSA_INVAL&#9;&#9;&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>所指定的</FONT><FONT SIZE=3>QOS</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>模板名字非法。</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">另请参阅：</FONT><FONT SIZE=3>  WSAConnect(), WSAAccept(), getsockopt().</P>
</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3><P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">　</P>
</FONT><B><FONT FACE="黑体" LANG="ZH-CN" SIZE=5><P><A NAME="_Toc336626917"><A NAME="_Toc336793000"><A NAME="_Toc336793476"></FONT><FONT FACE="Arial" SIZE=5>7.11 WSAHtonl()</A></A></A></P>
</B></FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3><P ALIGN="JUSTIFY">简述：将一个以主机字节顺序表示的无符号长整形数转换为网络字节顺序。</P>
<P ALIGN="JUSTIFY"></P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">          #include &lt;winsock2.h&gt;</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">          u_long WSAAPI WSAHtonl ( SOCKET  s, u_long</P>
<P ALIGN="JUSTIFY">          hostlong );</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">s</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：一个标识套接口的描述字。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">hostlong</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：一个用主机字节顺序表示的</FONT><FONT SIZE=3>32</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>位数。</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">返回值：</FONT><FONT SIZE=3>WSAHtonl()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>返回以网络字节顺序表示的值。</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">错误代码：</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSANOTINITIALISED&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>在调用本</FONT><FONT SIZE=3>API</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>之前应成功调用</FONT><FONT SIZE=3>WSAStartup()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSAENETDOWN&#9;&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>网络子系统失效。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">WSAENOTSOCK&#9;&#9;&#9;</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>描述字不是一个套接口。</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">另请参阅：</FONT><FONT SIZE=3>  htonl(), htons(), ntohs(), ntohl(), WSAHtons(),WSANtohl(), WSANtohs().</P>
</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3><P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">　</P>
</FONT><B><FONT FACE="黑体" LANG="ZH-CN" SIZE=5><P><A NAME="_Toc336626918"><A NAME="_Toc336793001"><A NAME="_Toc336793477"></FONT><FONT FACE="Arial" SIZE=5>7.12 WSAHtons()</A></A></A></P>
</B></FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3><P ALIGN="JUSTIFY">简述：将一个以主机字节顺序表示的无符号短整形数转换为网络字节顺序。</P>
<P ALIGN="JUSTIFY"></P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">          #include &lt;winsock2.h&gt;</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">          u_short WSAAPI WSAHtons (SOCKET sr, u_short</P>
<P ALIGN="JUSTIFY">          hostshort );</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">s</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：一个标识套接口的描述字。</P>
</FONT><FONT SIZE=3><P ALIGN="JUSTIFY">hostshort</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>：一个以主机字节顺序表示的</FONT><FONT SIZE=3>16</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>位数。</P>
<P ALIGN="JUSTIFY"></P>
<P ALIGN="JUSTIFY">返回值：</FONT><FONT SIZE=3>WSAHtons()</FONT><FONT FACE="宋体" LANG="ZH-CN" SIZE=3>返回以网络字节顺序表示的值。</P>
<P ALIGN="JUSTIFY"></P>