GetIpAddrTable 函数 （iphlpapi.h）

GetIpAddrTable 函数检索接口到 IPv4 地址映射表。

Syntax

IPHLPAPI_DLL_LINKAGE DWORD GetIpAddrTable(
  [out]     PMIB_IPADDRTABLE pIpAddrTable,
  [in, out] PULONG           pdwSize,
  [in]      BOOL             bOrder
);

参数

[out] pIpAddrTable

指向接收接口到 IPv4 地址映射表作为 MIB_IPADDRTABLE 结构的缓冲区的指针。

[in, out] pdwSize

在输入时，指定 pIpAddrTable 参数指向的缓冲区的大小（以字节为单位）。

在输出中，如果缓冲区不够大以容纳返回的映射表，则函数将此参数设置为等于所需的缓冲区大小（以字节为单位）。

[in] bOrder

如果此参数为 TRUE，则返回的映射表按 IPv4 地址按升序排序。 排序按网络字节顺序执行。 例如，10.0.0.255 紧随 10.0.1.0 之前。

返回值

如果函数成功，则返回值NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

注解

GetIpAddrTable 函数检索本地计算机上的接口到 IPv4 地址映射表，并在MIB_IPADDRTABLE结构中返回此信息。

GetIpAddrTable 函数返回的 IPv4 地址受本地计算机上的网络接口状态的影响。 手动重置网络接口卡（NIC）和某些 PnP 事件可能会导致 IP 地址被删除或更改。

在 Windows Server 2003 和 Windows XP 上，如果通过调用 DisableMediaSense 函数禁用 TCP/IP 堆栈的媒体感知功能，GetIpAddrTable 函数返回的 IPv4 地址也会受到影响。 禁用媒体感知后， GetIpAddrTable 函数可能会返回与断开连接接口关联的 IPv4 地址。 断开连接接口的这些 Ipv4 地址无效。

在 Windows Server 2008 和 Windows Vista 上， GetIpAddrTable 函数返回的 IPv4 地址不受本地计算机上的 TCP/IP 堆栈的媒体感知功能的影响。 GetIpAddrTable 函数仅返回有效的 IPv4 地址。

Windows XP 上提供的 GetAdaptersAddresses 函数可用于检索 IPv6 和 IPv4 地址和接口信息。

GetIpAddrTable 函数返回的MIB_IPADDRTABLE结构可能包含 dwNumEntries 成员与表成员中第一个MIB_IPADDRROW数组项之间的对齐填充。 表成员中MIB_IPADDRROW数组项之间也可能存在对齐的填充。 对 MIB_IPADDRROW 数组条目的任何访问都应假定填充可能存在。

在为 Windows Vista 及更高版本发布的 Microsoft Windows 软件开发工具包（SDK）上，头文件的组织已更改， MIB_IPADDRROW 在 Ipmib.h 头文件中定义，而不是 在 Iprtrmib.h 头文件中定义。 请注意， Ipmib.h 头文件自动包含在 Iprtrmib.h 中，该文件自动包含在 Iphlpapi.h 头文件中。 不应直接使用 Ipmib.h 和 Iprtrmib.h 头文件。

例子

以下示例检索 IP 地址表，然后打印表中 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))

/* Note: could also use malloc() and free() */

int __cdecl main()
{

    int i;
    
    /* Variables used by GetIpAddrTable */
    PMIB_IPADDRTABLE pIPAddrTable;
    DWORD dwSize = 0;
    DWORD dwRetVal = 0;
    IN_ADDR IPAddr;

    /* Variables used to return error message */
    LPVOID lpMsgBuf;

    // Before calling AddIPAddress we use GetIpAddrTable to get
    // an adapter to which we can add the IP.
    pIPAddrTable = (MIB_IPADDRTABLE *) MALLOC(sizeof (MIB_IPADDRTABLE));

    if (pIPAddrTable) {
        // Make an initial call to GetIpAddrTable to get the
        // necessary size into the dwSize variable
        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);
        }
    }
    // Make a second call to GetIpAddrTable to get the
    // actual data we want
    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),       // Default language
                          (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);
}

要求

另请参阅

AddIPAddress

DisableMediaSense

GetAdaptersAddresses

IP 帮助程序函数参考

IP_ADAPTER_ADDRESSES

MIB_IPADDRROW

MIB_IPADDRTABLE

RestoreMediaSense