TWSAData = packed record
wVersion: Word;
wHighVersion: Word;
szDescription: array[0..WSADESCRIPTION_LEN] of Char;
szSystemStatus: array[0..WSASYS_STATUS_LEN] of Char;
iMaxSockets: Word;
iMaxUdpDg: Word;
lpVendorInfo: PChar;
end;
wVersion中存放的是Windows Sockets DLL期望程序使用的版本号;wHighVersion是Windows Sockets DLL所支持的最高版本号,一般情况下,wHighVersion等于wVersion;
szDescription是一个以’\0’结尾的字符串,长度最长为256个字符,Windows Sockets DLL将Sockets实现的描述(包括Sockets开发商的标识信息)拷贝到该字符串中,在程序设计中,szDescription一般用来显示系统或程序的状态信息;
szSystemStatus是一个以’\0’结尾的字符串,Windows Sockets DLL将系统的相关状态、配置信息拷贝到该字符串中,如果该信息对用户、支持厂商有用的话,Windows Sockets DLL应利用该字符串,一般来讲,不把它看作szDescription的扩展;
iMaxSockets 指明单个进程可以打开的最大Sockets数目,任何一个Windows Sockets实现都会提供一个全局变量“Sockets池”,用于为每个进程分配Sockets,分配的数目会很好地反映Windows Sockets DLL或网络软件的配置方式,作为程序设计人员,我们可以利用这个数字来粗略地估计一下该Windows Sockets实现是否适用于我们开发的程序,例如,在X Windows服务器环境下,服务器第一次启动时会检查iMaxSockets,如果iMaxSockets小于8,应用程序会显示一条错误信息,告诉用户需要重新配置网络软件,在这种情况下,很少使用的szSystemStatus就派上用场了。很明显,谁也保证不了应用程序能够打开iMaxSockets个Sockets,因为系统中可能有其他的Windows Sockets应用程序在使用Sockets;
iMaxUdpDg 指明Windows Sockets应用程序可以接收或发送的最大UDP(用户数据文报协议)数据文报的大小(以字节表示),如果Sockets实现不加以限制,iMaxUdpDg则默认为0,而在许多伯克利Sockets实现中,对UDP数据文报有一个隐含的限制:8192字节,如果必要的话,可以将数据文报分成几段接收或发送,在兼容的Windows Sockets实现中,iMaxUdpDg的最小值通常是512字节;
lpszVendorInfo是一个长指针,指向一个开发商专用的数据结构,该变量与程序设计关系不大,在这里我们就不探讨它的具体结构了。
在程序设计过程中,首先要做的工作是初始化,程序是通过调用函数WSAStartup()来实现的,其作用是初始化Windows 套接字的动态连接库(Sockets DLL)。需要注意的是,该函数必须是程序或DLL(动态连接库)调用的所有Sockets函数中的第一个Sockets函数,其他套接字函数都是以该函数为基础的,只有该函数调用成功了,程序才能调用其他Sockets API(应用程序接口)函数,否则,程序就是无源之水,无本之木。所以,在程序的入口处,调用SocketsInitialize函数,在该函数内部调用WSAStartup()函数。
WSAStartup()的另一个作用是获得Windows Sockets API的版本号。我们知道,不同的操作系统有着不同的Sockets实现,即使是同一种操作系统,比如,都是Windows操作系统,但由于存在版本上的差异,Sockets的实现还是有差别的。为了将来程序的可移植性,有必要先判断平台所提供的Sockets DLL的版本号。调用WSAStartup()的程序与Windows Sockets DLL互相告诉对方彼此支持的最高版本,并确认是否能够支持对方的最高版本。调用WSAStartup()后,Windows Sockets DLL检查程序需要的Sockets版本号,如果该版本高于DLL所支持的最低版本号,那么,程序就会成功调用函数WSAStartup(),并返回版本号,DLL在数据类型WSADATA的wHighVersion中存入支持的最高版本号,在wVersion中存放wHighVersion和WS_VERSION_REQD二者中的最小值,从此往后,Windows Sockets DLL就认为程序所使用的版本号是wVersion。
如果无法接受wVersion中的版本号,那么,程序就应该进一步查找其他的Windows Sockets DLL或通知用户“初始化失败”。