Winsock_API_基本函数.docVIP

(VC link-Project Options 加入ws2_32.lib) 4.4 Winsock API基本函数——套接口与连接的建立 4.4.1 打开Winsock——WSAStartup(?) 应用程序或DLL只能在一次成功的WSAStartup(?)调用之后才能进一步调用其他的Windows Sockets API函数。 1．函数格式 WSAStartup(?)函数的格式如下： int WSAStartup( WORD wVersionRequested, LPWSADATA lpWSAData )； 2．函数参数说明 wVersionRequested：此参数是一个WORD型(双字节型)数值，它指定准备在应用程序中要使用的Winsock库的版本号。其中，用高位字节指定副版本，用低位字节指定主版本。就目前的Win32平台而言，Winsock 2库的必威体育精装版版本是2.2(Win95为Winsock 1.1)。如果需要加载Winsock 2.2版，指定此参数的值为0x0202；也可使用宏MAKEWORD(X,Y)，其中X为高位字节，Y为低位字节，如MAKEWORD(2,2)。 lpWSAData：此参数是一个指向WSADATA结构的指针。当该函数被调用时，它返回关于Windows Sockets实现的详细信息，该结构的定义如下： typedef struct WSAData{ WORD wVersion; WORD wHighVersion; Char szDescription[WSADESCRIPTION_LEN+1]; Char szSystemStatus[WSASYS_STATUS_LEN+1]; unsigned short iMaxSockets; unsigned short iMaxUdpDg; char FAR * lpVendorInfo; } WSADATA，FAR *LPWSADATA; 各字段的含义说明如下： ● wVersion：调用者希望使用的Winsock版本号； ●wHighVersion：加载的Winsock库所支持的最高Winsock版本,??通常和wVersion的值相同； ●szDescription：系统加载的Winsock库的说明字符串，如“Winsock 2.0”； ●szSystemStatus：系统状态或配置信息的说明字符串； ●iMaxSockets：套接口的最大编号(该字段被Winsock 2或其后的版本忽略)； ● iMaxUdpDg：UDP数据报的最大容量(该字段被Winsock 2或其后的版本忽略)； ●lpVendorInfo：厂商专有信息(该字段被Winsock 2或其后的版本忽略)。 3．函数返回信息 WSAStartup(?)函数的返回值是一个整数，如果调用成功则返回0。WSAStartup(?)函数调用不成功时返回如下的错误信息： ●WSASYSNOTREADY：在Winsock的头文件Winsock2.h中，该错误代码定义的数值为10091，它表明加载的Winsock DLL不存在或底层的网络子系统无法使用。 ●WSAVERNOTSUPPORTED：该代码的数值为10092，所需的Windows Sockets API的版本未由特定的Windows Sockets实现提供。?如果由wVersion返回的版本用户不能接受,则要调用WSACleanup(?)函数清除对Winsock的加载。 ●WSAEINVAL：该代码的数值为10022，说明应用程序指出的Windows Sockets版本不能被该Winsock DLL的实现所支持。 ●WSAEINPROGRESS：该代码的数值为10034，说明一个阻塞的Winsock调用正在进行中。 ●WSAEPROCLIM：该代码的数值为10047，说明已经达到了Windows Sockets实现所支持的任务数量的极限。 ●WSAEFAULT：该代码数值为10014，说明lpWSAData参数是一个无效的指针。 注意：在这里为了便于大家理解错误代码，列出了给错误代码定义的数值。以后为了节省篇幅，不再列出错误代码的数值。如果要查询对应错误代码对应的数值，可以在Winsock的头文件Winsock.h或Winsock2.h中去查找。 4．函数使用说明 如果用户在没有正确加载Winsock DLL的情况下使用了其他的Winsock API函数，则被调用的函数返回WSANOTINITIALISED错误信息，代码为10093。 该函数在