WSAStartup函数

转自：http://baike.baidu.com/view/2794415.htm

int WSAStartup ( WORD wVersionRequested, LPWSADATA lpWSAData )；wVersionRequested

　　⑴ wVersionRequested：一个WORD（双字节）型数值，指定了应用程序需要使用的Winsock规范的最高版本。

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

 

注释

 

本函数必须是应用程序或DLL调用的第一个Windows Sockets函数。它允许应用程序或DLL指明Windows Sockets API的版本号及获得特定Windows Sockets实现的细节。应用程序或DLL只能在一次成功的WSAStartup()调用之后才能调用进一步的Windows Sockets API函数。

一旦应用程序或DLL进行了一次成功的WSAStartup()调用，它就可以继续进行其它所需的Windows Sockets API调用。当它完成了使用该Windows Sockets DLL的服务后，应用程序或DLL必须调用WSACleanup()以允许Windows Sockets DLL释放任何该应用程序的资源。

 

返回值

　　0 成功。

　　否则返回下列的错误代码之一。注意通常依靠应用程序调用WSAGetLastError()机制获得的错误代码是不能使用的，因为Windows Sockets DLL可能没有建立“上一错误”信息储存的客户数据区域。

　　关于Windows Sockets提供者的说明：

　　每一个Windows Sockets应用程序必须在进行其它Windows Sockets API调用前进行WSAStartup()调用。这样，本函数就可以用于初始化的目的。

　　进一步的说明在WSACleanup()的说明中有讨论。

 

编辑本段错误代码

　　WSASYSNOTREADY 指出网络通信依赖的网络子系统还没有准备好。

　　WSAVERNOTSUPPORTED 所需的Windows Sockets API的版本未由特定的Windows Sockets实现提供。

　　WSAEINVAL 应用程序指出的Windows Sockets版本不被该DLL支持。