WSAStartup使用详解.pdfVIP

Windows 网络编程 WSAStartup使用详解 摘 要：首先说明WinSock编程中加载套接字库的一些基本内容，然后详细讲解了 WSAStartup 函数、WSACleanup 函数、WSAData 结构体的使用。最后给出示例代 码说明套接字库的加载和版本协商。 关键字：WSAStartup WSACleanup WSAData 套接字库加载 版本协商 Windows将socket的实现放到动态库中，利用套接字编程的第一步是加载套接字库。 系统加载套接字的函数是WSAStartup。在使用这个函数时要注意，如果应用程序要求的套 接字库版本号高于系统支持的版本号，WSAStartup返回成功，并且加载系统支持的最高版 本号。这就要求在加载套接字库后判断是否是应用程序需求的版本号。 每一次成功的调用了WSAStartup，都应该有对应的WSAClearup调用，以便于Winsock DLL释放启动时分配的资源。WSAStartup和WSAClearup可以多次调用，为了记录程序的 调用次数，WinSock使用一个内部计数器，初始值为0，调用一次WSAStartup加一，调用 一次WSAClearup减一。当减到0时，WSAClearup进行清除操作，它取消进程中任何线程 中正在进行的阻塞或异步调用，而且不发送通知或者向事件对象发送信号。WSAClearup也 取消正在进行的重叠操作，并且不设置事件对象或调用完成函数。 由于Windows将socket的实现放到动态库中，在用Winsock 的API编程时，需要加载 动态库。如果是加载2.2版本的套接字库，要使用winsock2.h头文件。示例代码如下 #includewinsock2.h #pragma comment(lib,ws2_32.lib) 上面的代码是调用Winsock2.2版本。版本 1.1是Winsock.h和wsock32.lib。 WSAStartup int WSAStartup( WORD wVersionRequested, LPWSADATA lpWSAData ); 功能：初始化WinSockDLL。本函数调用成功后才可以调用其他Winsock 函数。 参数： WORD wVersionRequested 加载套接字库的版本号。高位字节为副版本号，低位字节 为主版本号。一般可以用MAKEWORD宏来为这个参数赋值 （MAKEWORD宏的使用见文 章最后的附录）。 LPWSADATA lpWSAData 出参 指向一个WSADATA结构体。这个结构体中包含了 系统加载套接字库的相关信息（WSADATA结构体具体见本文WSADATA部分）。 返回值： 成功返回0，失败返回非零。常见的失败代码如下（注意这些失败代码不是通过 WSAGetLastError获得的，因为本函数没有调用成功，根本无法分配资源。所以这些代码是 直接返回的）： WSASYSNOTREADY 10091 底层的网络子系统无法使用 WSAVERNOTSUPPORTED 请求的版本系统不支持 WSAEINPROGRESS 一个阻塞的Socket正在调用 WSAEPROCLIM 任务数量已经到达了Socket所能够支持的最大数量 WSAEFAULT 参数lpWSAData 的指针时无效指针 1 3 第 页 共 页 Windows 网络编程 说明： 如果在参数wVersionRequested 中指定的Socket版本高于DLL 中支持的最低版本，函 数将调用成功。在参数lpWSAData指向的WSADATA变量中的wVersion成员保存了将要使 用的版本号。所以一般的程序都要检查使用的版本号是否为要求的版本号（关于版本协商的 更多内容见参考文献【2】）。常用的版本号1.1和2.2 WSAData结构体 structWSAData { WORD wVersion; //winsockdll 期望调用者使用的版本 WORD wHighVersion; //