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