《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
);