Socket学习随笔（一）

1、打开Winsock——WSAStartup()

使用Winsock API编制的网络应用程序中，在调用任何一个Winsock函数之前，都必须先检查协议栈的安装情况，也就是检查系统中是否有Windows Sockets的实现库。通过调用WSAStartup()函数便可检测系统中有没有一个或多个Windows Sockets实现，本函数必须是应用程序或DLL调用的第一个Windows Sockets函数，它允许应用程序或DLL指明Windows Sockets API的版本号及获得特定Windows
Sockets实现的细节。应用程序或DLL只能在一次成功的WSAStartup()调用之后才能进一步调用其他的Windows Sockets API函数。

1.1 函数的格式

int WSAStartup(WORD wVersionRequested,LPWSADATA lpWSAData);

1.2 参数说明

wVersionRequested:此参数是一个WORD型(双字节型)数值,它指定准备在应用程序中要使用的Winsock库的版本号。其中
，用高位字节指定副版本，用低位字节指定主版本。

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;
各字段的含义说明如下：
wVersion：调用者希望使用的Winsock版本号。
wHighVersion：加载的Winsock库所支持的最高Winsock版本，通常和wVersion的值相同。
szDescription：系统加载的Winsock库的说明字符串，如“Winsock
2.0”。
szSystemStatus：系统状态或配置信息的说明字符串。
iMaxSockets：套接口的最大编号(该字段被Winsock
2 或其后的版本忽略)。
iMaxUdpDg：UDP数据报的最大容量(该字段被Winsock
2 或其后的版本忽略)。
lpVendorInfo：厂商专有信息(该字段被Winsock
2 或其后的版本忽略)。
该结构中，WSAStartup()函数返回的比较有用的信息是wVersion和wHighVersion这两个关于Winsock版本的字段，
其他字段则很少用。
1.3
函数返回信息
WSAStartup()函数的返回值是一个整数，如果调用成功则返回0
WSAStartup()函数调用不成功时返回如下的错误信息：
WSASYSNOTREADY：在Winsock的 头文件Winsock.h中，该错误代码定义的数值为10091，它表明加载的Winsock
DLL不存在或底层的网络子 系统无法使用。

WSAVERNOTSUPPORTED：该代码的数值为10092，所需的Windows
Sockets API的版本未由特定的Windows Sockets实现提供。如果由
wVersion返回的版本用户不能接受，则要调用WSACleanup()函数清除对Winsock的加载。
WSAEINVAL：该代码的数值为10022，说明应用程序指出的Windows
Sockets版本不能被该Winsock DLL的实现所支持。
WSAEINPROGRESS：该代码的数值为10036，说明一个阻塞的Winsock调用正在进行中。
WSAEPROCLIM：该代码的数值为10067，说明已经达到了Windows
Sockets实现所支持的任务数量的极限
WSAEFAULT：该代码的数值为10014，说明lpWSAData参数是一个无效的指针。
。。。。。。
1.4 函数使用说明
该函数在程序中的基本使用方法如下：
#include<Winsock2.h>
//...其他代码
WORD wVersionRequested;
WSADATA wsaData;
wVersionRequested = MAKEWORD(2,
2);

if(WSAStartup(wVersionRequested,
&wsaData) != 0)
{
//Winsock初始化错误
//输出Winsock初始化错误提示信息
return;
}
//...其他代码

结束对Winsock DLL库的使用时，一定要调用WSACleanup()函数卸载所加载的库。