在vb中使用Iphlpapi.dll获取网络信息 第二章 第一节 获取本机网络适配器的信息

※==================================================================
※本连载文章说明：
※1、连载首发于《软件报》（http://www.sweek.com）2006年21期（2006年5月22日）；
※2、此次网上连载采用的是原稿件结构，内容与《软件报》发表略有不同；
※3、谢绝除《软件报》及其相关刊物之外的传统媒体部分或全部转载；
※4、谢绝任何收费媒体、网络转载；
※5、原作者：uruseibest ，blog：http://blog.csdn.net/uruseibest；
※6、如有其它疑问，请联系作者；
※7、如有转载，必须连同本说明一并发表，否则将追究转载者责任。
※======================================================================

第二章 IPHLPAPI 的主要函数

本章将根据iphlpapi.dll提供函数的功能来分别讲解iphlpapi.dll的主要函数。编程时，我们可以调用这些函数迅速获得本机大部分网络信息。

第一节 获取本机网络适配器的信息

1、函数：

Private Declare Function GetAdaptersInfo Lib "iphlpapi.dll" ( IpAdapterInfo As Any, pOutBufLen As Long) As Long

参数说明：

pAdapterInfo：[输出] 指向一个IP_ADAPTER_INFO类型的连接表；

pOutBufLen：[输入] 指定pAdapterInfo参数的大小，如果指定大小不足，GetAdaptersInfo将此参数置为所需大小, 并返回一个ERROR_BUFFER_OVERFLOW错误代码。

返回值：成功，返回0；失败，返回错误代码。

备注：此函数不能获得回环（Loopback）适配器的信息

2、使用到的类型：

①IP_ADAPTER_INFO类型：包含本机网络适配器信息。

Type IP_ADAPTER_INFO

Next As Long                ‘在适配器列表中指向下一个适配器

ComboIndex As Long    ‘保留未用

AdapterName As String * MAX_ADAPTER_NAME_LENGTH                ‘适配器名

Description As String * MAX_ADAPTER_DESCRIPTION_LENGTH     

‘对网卡的描述，实际上好象是驱动程序的名字

AddressLength As Long        ‘适配器物理地址的长度

Address(MAX_ADAPTER_ADDRESS_LENGTH - 1) As Byte         

‘物理地址，每个字节存放一个十六进制的数值

Index As Long                     ‘适配器索引号

Type As Long               ‘适配器类型，包含以下类型的适配器（见下表）：

常量名称	值	说明
MIB_IF_TYPE_ETHERNET	6	以太网适配器
MIB_IF_TYPE_TOKENRING	9	令牌环适配器
MIB_IF_TYPE_FDDI	15	光纤接口适配器
MIB_IF_TYPE_PPP	23	点到点协议适配器
MIB_IF_TYPE_LOOPBACK	24	回环（Loopback）适配器
MIB_IF_TYPE_SLIP	28	串行适配器(Serial Line Interface Protocol)
MIB_IF_TYPE_OTHER	其他值	其他类型的适配器

     

DhcpEnabled As Long           ‘适配器是否启用了动态主机配置协议（DHCP）

CurrentIpAddress As Long    ‘保留（当前使用的IP地址？）

IpAddressList As IP_ADDR_STRING        ‘绑定到此适配器的IP地址链表

GatewayList As IP_ADDR_STRING          ‘默认网关地址链表

DhcpServer As IP_ADDR_STRING         ‘DHCP服务器地址，DhcpEnabled=TRUE时有效

HaveWins As Byte         ‘是否启用WINS（Windows Internet Name Service）

PrimaryWinsServer As IP_ADDR_STRING              ‘主WINS地址

SecondaryWinsServer As IP_ADDR_STRING           ‘辅WINS地址

LeaseObtained As Long  ‘向DHCP服务器租用IP地址的时间，DhcpEnabled=TRUE时有效

LeaseExpires As Long    ‘向DHCP服务器租用IP地址到期时间，DhcpEnabled=TRUE时有效

End Type

② IP_ADDR_STRING描述IP 地址链表的节点。

Type IP_ADDR_STRING

Next As Long         ‘指向列表中下一个IP_ADDR_STRING类型。为空，则是最后一个地址

IpAddress As String * 16      ‘点式十进制字串表示Ip地址

IpMask As String * 16          ‘子网掩码

Context As Long                  ‘网络IP地址标识，符合AddIPAddress和DeleteIPAddress函数中的网络接口关联参数。

End Type

 

3、使用到的常量：

Const MAX_ADAPTER_NAME_LENGTH = 260

Const MAX_ADAPTER_ADDRESS_LENGTH = 8

Const MAX_ADAPTER_DESCRIPTION_LENGTH = 132

 

4、主要代码分析：

①调用函数GetAdaptersInfo，以及在调用中应该注意的问题：对函数GetAdaptersInfo进行两次调用，第一次调用获得参数pOutBufLen的实际大小；第二次调用获取IpAdapterInfo的数据。代码如下：

pOutBufLen = 0

error = GetAdaptersInfo(ByVal 0&, pOutBufLen)       

ReDim AdapterInfoBuffer(pOutBufLen - 1)

error = GetAdaptersInfo(AdapterInfoBuffer(0), pOutBufLen)

 

② IpAdapterInfo中可能包含多个IP_ADAPTER_INFO类型，因此下一步使用copymemory函数将数据拷贝到IP_ADAPTER_INFO类型：

CopyMemory AdapterInfo, AdapterInfoBuffer(0), pOutBufLen

 

③获得了首个IP_ADAPTER_INFO类型后，根据IP_ADAPTER_INFO类型中的Next成员并调用循环语句(Do…Loop Until)来获得所有IP_ADAPTER_INFO类型：

Do

pAdapt = AdapterInfo.Next

If pAdapt <> 0 Then

CopyMemory AdapterInfo, ByVal pAdapt, AdapterInfoSize

End If

Loop Until pAdapt = 0

 

④由每次获得的IP_ADAPTER_INFO类型来获取网络适配器物理地址：

    PhysicalAddress = ""

    For i = 0 To AdapterInfo.AddressLength - 1

        PhysicalAddress = PhysicalAddress & Hex(AdapterInfo.Address(i))

        If i < AdapterInfo.AddressLength - 1 Then

            PhysicalAddress = PhysicalAddress & "-"

        End If

Next

 

⑤对于属于IP_ADDR_STRING类型的IpAddressList、GatewayList、DhcpServer、PrimaryWinsServer、SecondaryWinsServer，同样要注意IP_ADDR_STRING中Next成员的使用：

    Do

        CopyMemory IP_ADDR_STRING, AdapterInfo.IpAddressList, LenB(IP_ADDR_STRING)

        Print "IP Address: " & IP_ADDR_STRING.IpAddress

        Print "Subnet Mask: " & IP_ADDR_STRING.IpMask

        pAddrStr = IP_ADDR_STRING.Next

        If pAddrStr <> 0 Then

            CopyMemory IP_ADDR_STRING.IpAddressList, ByVal pAddrStr, _

                   LenB(IP_ADDR_STRING.IpAddressList)

        End If

    Loop Until pAddrStr = 0

 

5、运行时截图：