WSAEnumProtocols函数的用法

最新推荐文章于 2024-05-22 12:25:56 发布

原创最新推荐文章于 2024-05-22 12:25:56 发布 · 1.7k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#socket #null #网络 #windows #dll

windows网络编程专栏收录该内容

8 篇文章

订阅专栏

本文详细介绍了Windows网络编程中WSAEnumProtocols函数的使用方法，包括参数解释、常见错误及解决策略。通过实例演示了如何正确调用此函数以获取特定协议信息。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

今天看到《windows网络编程》第二版里面有一个函数, 在第一次按照说明使用的时候没有成功. 以下是对应的技术说明.

　　#include <winsock2.h>

　　int WSAAPI WSAEnumProtocols ( LPINT lpdwProtocols,

　　LPWSAPROTOCOL_INFO lpProtocolBuffer,

　　LPDWORD lpdwBufferLength);

　　lpdwProtocols：一个以NULL结尾的协议标识号数组。本参数可选；如果lpdwProtocols为 NULL，则返回所有可用协议的信息，否则的话只返回数组中所开列的协议信息。

　　lpProtocolBuffer：一个用PROTOCOL_INFO结构填充的缓冲区。参见下文中对PROTOCOL_INFO结构的具体描述。

　　lpdwBufferLength：输入时，存有传递给WSAEnumProtocols()函数的lpProtocolBuffer缓冲区长度。输出时，表示为获取所有信息需传递给WSAEnumProtocols()函数的缓冲区长度。本函数不能重复调用；传入的缓冲区必须足够大以能存放所有的元素。这个规定降低了该函数的复杂度。由于一个机器上装载的协议数目往往是很小的，所以并不会产生问题。

　　返回值：

　　若无错误发生，WSAEnumProtocols()返回协议的数目。否则的话，将返回INVALID_SOCKET错误，应用程序可通过WSAGetLastError()来获取相应的错误代码。

　　错误代码：

　　WSANOTINITIALISED 在调用本API之前应成功调用WSAStartup()。

　　WSAENETDOWN 网络子系统失效。

　　WSAEINPROGRESS 一个阻塞WinSock调用正在进行。

　　WSAEINVAL 参数中有非法值。

　　WSAENOBUFS 缓冲区太小，无法保存所有PROTOCOL_INFO结构及其相关信息。传入的缓冲区大小至少应等于lpdwBufferLength中返回的值。

　　通常需要两次调用WSAEnumProtocols()函数以获取特定的协议信息，第一次调用时指定lpdwProtocols为 NULL，调用肯定是失败的，但参数lpdwBufferLength包含了所以协议信息需要的缓冲区长度。我们知道了这个准确长度就可以进行第二次调用了！

后来查找到原因, 因为我只做局部测试代码, 没有加载socket的DLL, 造成失败调用. 贴一段正确使用的代码:

//代码来源为:http://blog.youkuaiyun.com/chshji666666/article/details/6758260

#include <Winsock2.h>   
#include <stdio.h>   
#pragma comment(lib, "ws2_32.lib")   
  
void main(void)  
{  
     WSADATA wsaData;  
     WSAStartup( MAKEWORD( 2, 2 ), &wsaData );  
  
     LPWSAPROTOCOL_INFO info = NULL;  
     DWORD dwLen;  
  
     //因为info还未分配内存，第一次调用必定会失败，但能够得到dwLen的值   
     if (SOCKET_ERROR == WSAEnumProtocols(NULL, info, &dwLen))  
     {  
         int iErrorCode = GetLastError();  
         if (WSAENOBUFS != iErrorCode)  
         {  
             WSACleanup();  
             return;  
         }                  
     }  
  
     if (dwLen > 0)  
     {  
  
       //如果没有分配内存这一步，将会出错，只传递 &inof是没有用的,注意指针的用法   
        info = (LPWSAPROTOCOL_INFO)GlobalAlloc(GPTR, dwLen);  
         if (info == NULL)  
         {  
             printf("Allocate memory failed! ErrorCode is %d", GetLastError());  
             WSACleanup();  
             return;              
         }  
  
         //第二次调用   
         int iProtocolCounts = WSAEnumProtocols(NULL, info, &dwLen);      
         if (SOCKET_ERROR == iProtocolCounts)  
         {  
             printf("WSCEnumProtocols Error: %d", GetLastError());  
             GlobalFree(info);  
             WSACleanup();  
             return;      
         }  
  
         //打印本机安装的协议信息   
         for (int i=0; i<iProtocolCounts; i++)  
         {  
             printf("\ni=%d\nProtocolDescription:%s\n", i, info[i].szProtocol);              
         }  
  
         GlobalFree(info);      
     }  
     WSACleanup();  
}