《Windows API巡礼》---WSAStartup和WSACleanup

由于Winsock在被调用时是以动态链接库Winsock.dll的形式实现的，所以在它初始化时应首先调用WSAStartup函数，对Winsock DLL进行初始化，确定被调用的Winsock的版本号，并以此分配必要的资源：

int WSAStartup(

__in WORD wVersionRequested, //用于存储要加载的Winsock库的版本；一般高位字节用于存储

//Winsock库的副版本，而低位字节则用来存储主版本，

//使用MAKEWORD(X, Y)构造一个完整的版本信息

__out LPWSADATA lpWSAData //指向WSAData结构的指针，该结构包含了加载库版本的相关信息

);

返回值：

成功时，返回0；

失败时，直接返回错误码，不用也不能再调用WSAGetLastError()函数

typedef struct WSAData {

WORD wVersion; //当前使用的版本信息

WORD wHighVersion; //Winsock库最高版本号

char szDescription[WSADESCRIPTION_LEN+1]; //闲置不用

char szSystemStatus[WSASYS_STATUS_LEN+1]; //闲置不用

unsigned short iMaxSockets; //同时打开的套接字个数

unsigned short iMaxUdpDg; //数据包最大长度

char FAR *lpVendorInfo; //为指定厂商信息预留

} WSADATA, *LPWSADATA;

WSACleanup函数用于终止对Winsock DLL的使用，并释放资源：

int WSACleanup(void);

返回值：

成功时，返回0；

失败时，返回SOCKET_ERROR，调用WSAGetLastError函数可查看进一步错误信息。

在多线程环境中，WSACleanup终止所有线程的socket操作。

实例代码如下：

#pragma comment(lib, "wininet.lib")

#include <winsock2.h>

#include <ws2tcpip.h>

#include <stdio.h>

#include <windows.h>

int __cdecl main()

{

WORD wVersionRequested;

WSADATA wsaData;

int err;

/* Use the MAKEWORD(lowbyte, highbyte) macro declared in Windef.h */

wVersionRequested = MAKEWORD(2, 2);

err = WSAStartup(wVersionRequested, &wsaData);

if (err != 0) {

/* Tell the user that we could not find a usable */

/* Winsock DLL. */

printf("WSAStartup failed with error: %d/n", err);

return 1;

}

/* Confirm that the WinSock DLL supports 2.2.*/

/* Note that if the DLL supports versions greater */

/* than 2.2 in addition to 2.2, it will still return */

/* 2.2 in wVersion since that is the version we */

/* requested. */

if (LOBYTE(wsaData.wVersion) != 2 || HIBYTE(wsaData.wVersion) != 2) {

/* Tell the user that we could not find a usable */

/* WinSock DLL. */

printf("Could not find a usable version of Winsock.dll/n");

WSACleanup();

return 1;

}

else

printf("The Winsock 2.2 dll was found okay/n");

/* The Winsock DLL is acceptable. Proceed to use it. */

/* Add network programming using Winsock here */

/* then call WSACleanup when down using the Winsock dll */

WSACleanup();

}

附：

MAKEWORD宏用于拼接两个指定的BYTE值，得到一个WORD值：

WORD MAKEWORD(

BYTE bLow, //新值的低位字节

BYTE bHigh //新值的高位字节

);

返回值是一个WORD值。

LOBYTE宏用于从指定的WORD值获取其低位字节：

BYTE LOBYTE(

WORD wValue

);

HIBYTE宏用于从指定的WORD值获取其高位字节：

BYTE HIBYTE(

WORD wValue

);