WSADATA

最新推荐文章于 2021-10-29 11:28:34 发布

weixin_34050519

最新推荐文章于 2021-10-29 11:28:34 发布

阅读量584

点赞数

文章标签：操作系统 c/c++ 网络

中文名

WSADATA

操作系统

Windows CE

版本：

大于等于1.0

定义位置：

Winsock.h

说明编辑

WSADATA结构被用来储存调用AfxSocketInit 全局函数返回的 Windows Sockets 初始化信息。

这个结构被用来存储被 WSAStartup 函数调用后返回的 Windows Sockets数据。它包含 Winsock.dll执行的数据。

结构原型编辑

 
         摘自<winsock.h> 
        
         typedef  
         struct  
         WSAData { 
        
         WORD                     
         wVersion; 
        
         WORD                     
         wHighVersion; 
        
         #ifdef _WIN64 
        
         unsigned  
         short           
         iMaxSockets; 
        
         unsigned  
         short           
         iMaxUdpDg; 
        
         char  
         FAR *              lpVendorInfo; 
        
         char                     
         szDescription[WSADESCRIPTION_LEN+1]; 
        
         char                     
         szSystemStatus[WSASYS_STATUS_LEN+1]; 
        
         #else 
        
         char                     
         szDescription[WSADESCRIPTION_LEN+1]; 
        
         char                     
         szSystemStatus[WSASYS_STATUS_LEN+1]; 
        
         unsigned  
         short           
         iMaxSockets; 
        
         unsigned  
         short           
         iMaxUdpDg; 
        
         char  
         FAR *              lpVendorInfo; 
        
         #endif 
        
         } WSADATA; 
        
         WSADATA结构被用来保存AfxSocketInit函数返回的WindowsSockets初始化信息。

参数说明编辑

wVersion

Windows Sockets DLL期望调用者使用的Windows Sockets规范的版本。高位字节存储副版本号, 低位字节存储主版本号，可以用WORD MAKEWORD(BYTE,BYTE ) 返回这个值,例如:MAKEWORD(1,1)

wHighVersion

这个DLL能够支持的Windows Sockets规范的最高版本。通常它与wVersion相同。

szDescription

以null结尾的ASCII字符串，Windows Sockets DLL将对Windows Sockets实现的描述拷贝到这个字符串中，包括制造商标识。文本（最多可以有256个字符）可以包含任何字符，但是要注意不能包含控制字符和格式字符，应用程序对其最可能的使用方式是把它（可能被截断）显示在在状态信息中。

szSystemStatus

以null结尾的ASCII字符串，Windows Sockets DLL把有关的状态或配置信息拷贝到该字符串中。Windows Sockets DLL应当仅在这些信息对用户或支持人员有用时才使用它们，它不应被作为szDescription域的扩展。

iMaxSockets

单个进程能够打开的socket的最大数目。Windows Sockets的实现能提供一个全局的socket池，可以为任何进程分配；或者它也可以为socket分配属于进程的资源。这个数字能够很好地反映Windows Sockets DLL或网络软件的配置方式。应用程序的编写者可以通过这个数字来粗略地指明Windows Sockets的实现方式对应用程序是否有用。例如，X Windows服务器在第一次启动的时候可能会检查iMaxSockets的值：如果这个值小于8，应用程序将显示一条错误信息，指示用户重新配置网络软件（这是一种可能要使用szSystemStatus文本的场合）。显然无法保证某个应用程序能够真正分配iMaxSockets个socket，因为可能有其它WindowsSockets应用程序正在使用。

iMaxUdpDg

Windows Sockets应用程序能够发送或接收的最大的用户数据包协议（UDP）的数据包大小，以字节为单位。如果实现方式没有限制，那么iMaxUdpDg为零。在Berkeley sockets的许多实现中，对于UDP数据包有个固有的限制（在必要时被分解），大小为8192字节。Windows Sockets的实现可以对碎片重组缓冲区的分配作出限制。对于适合的WindowsSockets 实现，iMaxUdpDg的最小值为512。注意不管iMaxUdpDg的值是什么，都不推荐你发回一个比网络的最大传送单元（MTU）还大的广播数据包。（Windows Sockets API 没有提供发现MTU的机制，但是它不会小于512个字节)。WinSock2.0版中已被废弃。

lpVendorInfo

指向销售商的数据结构的指针。这个结构的定义（如果有）超出了 WindowsSockets规范的范围。WinSock2.0版中已被废弃。