介绍

int WSAStartup( WORD wVersionRequested, LPWSADATA lpWSAData);

为了在应用程序当中调用任何一个Winsock API函数，首先第一件事情就是必须通过WSAStartup函数完成对Winsock服务的初始化，因此需要调用WSAStartup函数。使用Socket的程序在使用Socket之前必须调用WSAStartup函数。该函数的第一个参数指明程序请求使用的Socket版本，其中高位字节指明副版本、低位字节指明主版本；操作系统利用第二个参数返回请求的Socket的版本信息。当一个应用程序调用WSAStartup函数时，操作系统根据请求的Socket版本来搜索相应的Socket库，然后绑定找到的Socket库到该应用程序中。以后应用程序就可以调用所请求的Socket库中的其它Socket函数了。

函数定义

int WSAStartup ( WORD wVersionRequested, LPWSADATA lpWSAData )；

⑴ wVersionRequested：一个WORD（双字节）型数值，在最高版本的Windows Sockets支持调用者使用，高阶字节指定小版本(修订本)号,低位字节指定主版本号。

⑵lpWSAData 指向WSADATA数据结构的指针，用来接收Windows Sockets1实现的细节。

WindowsSockets API提供的调用方可使用的最高版本号。高位字节指出副版本(修正)号，低位字节指明主版本号。

注释

为支持日后可能和Windows Sockets 1.1有功能上差异的Windows Sockets实现及应用程序，在WSAStartup()中规定了一个协议。WSAStartup()的调用方和Windows Sockets DLL互相通知对方它们可以支持的最高版本，并且互相确认对方的最高版本是可接受的。在WSAStartup()函数的入口，Windows Sockets DLL检查了应用程序所需的版本。如果程序所需Sockets版本等于或高于DLL支持的最低版本2（MSDN: If the version requested by the application is equal to or higher than the lowest version supported by the Winsock DLL, the call succeeds and...），则调用成功并且DLL在wHighVersion中返回它所支持的最高版本，在wVersion中返回它的高版本和wVersionRequested中的较小者。然后Windows Sockets DLL就会假设应用程序将使用wVersion.如果WSDATA结构中的wVersion域对调用方来说不可接收，它就应调用WSACleanup()函数并且要么去另一个Windows Sockets DLL中搜索，要么初始化失败。

本协议允许Windows Sockets DLL和Windows Sockets应用程序共同支持一定范围的Windows Sockets版本。如果版本范围有重叠，应用程序就可以成功地使用Windows Sockets DLL。下列的图表给出了WSAStartup()在不同的应用程序和Windows Sockets DLL版本中是如何工作的：

应用程序版本 DLL版本 wVersionRequested wVersion wHighVersion 最终结果

1.1 1.1 1.1 1.1 1.1 use 1.1

1.0 1.1 1.0 1.1 1.0 1.0 use 1.0

1.0 1.0 1.1 1.0 1.0 1.1 use 1.0

1.1 1.0 1.1 1.1 1.1 1.1 use 1.1

1.1 1.0 1.1 1.0 1.0 失败

1.0 1.1 1.0 －- －- WSAVERNOTSUPPORTED

1.0 1.1 1.0 1.1 1.1 1.1 1.1 use 1.1