MIB_IPADDRTABLE结构是一张Ipv4地址入口表,其定义如下:

typedef struct _MIB_IPADDRTABLE {

  DWORD         dwNumEntries;  //表中Ipv4地址入口的个数

  MIB_IPADDRROW table[ANY_SIZE];  //一个指向实现为MIB_IPADDRROW结构数组

                                                                                      //的Ipv4地址入口表的指针

} MIB_IPADDRTABLE, *PMIB_IPADDRTABLE;

 

MIB_IPADDRROW结构存储了MIB_IPADDRTABLE结构中特定的Ipv4地址的详细信息,其定义如下:

typedef struct _MIB_IPADDRROW {

  DWORD          dwAddr;   //遵循网络字节序的Ipv4地址

  DWORD          dwIndex;   //与Ipv4地址关联的接口索引

  DWORD          dwMask;   //遵循网络字节序的Ipv4地址的子网掩码

  DWORD          dwBCastAddr;   //遵循网络字节序的广播地址,通常是Ipv4地址的//主机号设为全0或全1

  DWORD          dwReasmSize;   //接收到的数据报最大的重组装大小

  unsigned short   //该参数保留

  unsigned short   //网址类型或状态,这个值可以是下表各个值的组合

} MIB_IPADDRROW, *PMIB_IPADDRROW;


 

GetIpAddrTable函数检索本地计算机上Ipv4地址映射表的接口,并将接口信息以MIB_IPADDRTABLE结构返回,其定义如下:

DWORD GetIpAddrTable(

  __out    PMIB_IPADDRTABLE pIpAddrTable,  //指向存储Ipv4地址映射表的接口的

//指针,这些接口以MIB_IPADDRTABLE结构表示

  __inout  PULONG pdwSize,  //当作为输入参数时,表示plpAddrTable所指向的内存

                                                              //的字节大小;当作为输出参数时,表示plpAddrTable指向的

//内存空间不够,这个值表示实际需要的字节大小

  __in     BOOL bOrder //该参数指示函数返回的映射表中的Ipv4地址是否按升序排

//列,为TRUE时表示进行排序

);

当函数执行成功时,返回值是NO_ERROR;执行失败时,返回值是下表之一:


 

下面是检索IP地址映射表的例子程序:

#include <winsock2.h>
#include <ws2tcpip.h>
#include <iphlpapi.h>
#include <stdio.h>

#pragma comment(lib, "iphlpapi.lib")
#pragma comment(lib, "ws2_32.lib")

#define MALLOC(x) HeapAlloc(GetProcessHeap(), 0, (x))
#define FREE(x) HeapFree(GetProcessHeap(), 0, (x))
//也可以使用malloc()和free()

int __cdecl main()
{
int i;
//GetIpAddrTable用到的变量
PMIB_IPADDRTABLE pIPAddrTable;
DWORD dwSize = 0;
DWORD dwRetVal = 0;
IN_ADDR IPAddr;

//返回错误信息的变量
LPVOID lpMsgBuf;

//在调用AddIPAddress函数之前我们先调用GetIpAddrTable函数
//来获得可以用来增加IP地址的适配器
pIPAddrTable = (MIB_IPADDRTABLE*)MALLOC(sizeof(MIB_IPADDRTABLE));
if(pIPAddrTable)
{
//第一次调用GetIpAddrTable来获得所需的内存字节大小,并存入dwSize参数中
if(GetIpAddrTable(pIPAddrTable, &dwSize, 0) == ERROR_INSUFFICIENT_BUFFER)
{
FREE(pIPAddrTable);
pIPAddrTable = (MIB_IPADDRTABLE*)MALLOC(dwSize);
}
if(pIPAddrTable == NULL)
{
printf("Memory allocation failed for GetIpAddrTable/n");
exit(1);
}
}

//第二次调用GetIpAddrTable函数来获得我们实际需要的数据
if((dwRetVal = GetIpAddrTable(pIPAddrTable, &dwSize, 0)) != NO_ERROR)
{
printf("GetIpAddrTable failed with error %d/n", dwRetVal);
if(FormatMessage(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM |
FORMAT_MESSAGE_IGNORE_INSERTS, NULL, dwRetVal, MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
(LPTSTR)&lpMsgBuf, 0, NULL))
{
printf("/tError : %s", lpMsgBuf);
LocalFree(lpMsgBuf);
}
exit(1);
}

printf("/tNum Entries: %ld/n", pIPAddrTable->dwNumEntries);
for(i=0; i<(int)pIPAddrTable->dwNumEntries; i++)
{
printf("/n/tInterface Index[%d]: /t%ld/n", i, pIPAddrTable->table[i].dwIndex);
IPAddr.S_un.S_addr = (u_long)pIPAddrTable->table[i].dwAddr;
printf("/tIP Address[%d]: /t%s/n", i, inet_ntoa(IPAddr));

IPAddr.S_un.S_addr = (u_long)pIPAddrTable->table[i].dwMask;
printf("/tSubnet Mask[%d]: /t%s/n", i, inet_ntoa(IPAddr));

IPAddr.S_un.S_addr = (u_long)pIPAddrTable->table[i].dwBCastAddr;
printf("/tBroadCast[%d]: /t%s(%ld)/n", i, inet_ntoa(IPAddr), pIPAddrTable->table[i].dwBCastAddr);
printf("/tReassembly size[%d]: /t%ld/n", i, pIPAddrTable->table[i].dwReasmSize);

printf("/tType and State[%d]: ", i);
if(pIPAddrTable->table[i].wType & MIB_IPADDR_PRIMARY)
printf("/tPrimary IP Address");
if(pIPAddrTable->table[i].wType & MIB_IPADDR_DYNAMIC)
printf("/tDynamic IP Address");
if(pIPAddrTable->table[i].wType & MIB_IPADDR_DISCONNECTED)
printf("/tAddress is on disconnected interface");
if(pIPAddrTable->table[i].wType & MIB_IPADDR_DELETED)
printf("/tAddress is being deleted");
if(pIPAddrTable->table[i].wType & MIB_IPADDR_TRANSIENT)
printf("/tTransient address");
printf("/n");
}

if(pIPAddrTable)
{
FREE(pIPAddrTable);
pIPAddrTable = NULL;
}
exit(0);
}

在本人ACER电脑上运行结果如下: