Share via

MIB_UNICASTIPADDRESS_ROW 结构 (netioapi.h)

  • 项目

MIB_UNICASTIPADDRESS_ROW结构存储有关单播 IP 地址的信息。

语法

typedef struct _MIB_UNICASTIPADDRESS_ROW {
  SOCKADDR_INET    Address;
  NET_LUID         InterfaceLuid;
  NET_IFINDEX      InterfaceIndex;
  NL_PREFIX_ORIGIN PrefixOrigin;
  NL_SUFFIX_ORIGIN SuffixOrigin;
  ULONG            ValidLifetime;
  ULONG            PreferredLifetime;
  UINT8            OnLinkPrefixLength;
  BOOLEAN          SkipAsSource;
  NL_DAD_STATE     DadState;
  SCOPE_ID         ScopeId;
  LARGE_INTEGER    CreationTimeStamp;
} MIB_UNICASTIPADDRESS_ROW, *PMIB_UNICASTIPADDRESS_ROW;

成员

Address

类型： SOCKADDR_INET

单播 IP 地址。 此成员可以是 IPv6 地址或 IPv4 地址。

InterfaceLuid

类型： NET_LUID

本地唯一标识符 (与此 IP 地址关联的网络接口的 LUID) 。

InterfaceIndex

类型： NET_IFINDEX

与此 IP 地址关联的网络接口的本地索引值。 当网络适配器被禁用并随后启用时，或者在其他情况下，此索引值可能会更改，并且不应被视为永久性。

PrefixOrigin

类型： NL_PREFIX_ORIGIN

IP 地址的前缀或网络部分的来源。 此成员可以是 Nldef.h 头文件中定义的 NL_PREFIX_ORIGIN 枚举类型的值之一。

值 含义
IpPrefixOriginOther
0
 IP 地址前缀是使用此枚举中定义的源以外的其他源配置的。 此值适用于 IPv6 或 IPv4 地址。
IpPrefixOriginManual
1
 IP 地址前缀是手动配置的。 此值适用于 IPv6 或 IPv4 地址。
IpPrefixOriginWellKnown
2
 IP 地址前缀是使用已知地址配置的。 此值适用于 IPv6 链接本地地址或 IPv6 环回地址。
IpPrefixOriginDhcp
3
 IP 地址前缀是使用 DHCP 配置的。 此值适用于使用 DHCP 配置的 IPv4 地址或使用 DHCPv6 配置的 IPv6 地址。
IpPrefixOriginRouterAdvertisement
4
 IP 地址前缀是使用路由器播发配置的。 此值适用于接收路由器播发后生成的匿名 IPv6 地址。
IpPrefixOriginUnchanged
16
 IP 地址前缀应保持不变。 当 IP 前缀源的值应保持不变时，设置单播 IP 接口的属性时，将使用此值。

SuffixOrigin

类型： NL_SUFFIX_ORIGIN

IP 地址的后缀或主机部分的来源。 此成员可以是 Nldef.h 头文件中定义的 NL_SUFFIX_ORIGIN 枚举类型的值之一。

值 含义
IpSuffixOriginother
0
 IP 地址后缀是使用此枚举中定义的源以外的源配置的。 此值适用于 IPv6 或 IPv4 地址。
IpSuffixOriginManual
1
 IP 地址后缀是手动配置的。 此值适用于 IPv6 或 IPv4 地址。
IpSuffixOriginWellKnown
2
 IP 地址后缀是使用已知地址配置的。 此值适用于 IPv6 链接本地地址或 IPv6 环回地址。
IpSuffixOriginDhcp
3
 IP 地址后缀是使用 DHCP 配置的。 此值适用于使用 DHCP 配置的 IPv4 地址或使用 DHCPv6 配置的 IPv6 地址。
IpSuffixOriginLinkLayerAddress
4
 IP 地址后缀是链接本地地址。 此值适用于 IPv6 链接本地地址或 IPv6 地址，其中网络部件基于路由器播发生成，主机部件基于 MAC 硬件地址。
IpSuffixOriginRandom
5
 IP 地址后缀是随机生成的。 此值适用于匿名 IPv6 地址，其中地址的主机部分是在收到路由器播发后从 MAC 硬件地址随机生成的。
IpSuffixOriginUnchanged
16
 IP 地址后缀应保持不变。 当 IP 后缀源的值应保持不变时，设置单播 IP 接口的属性时，将使用此值。

ValidLifetime

类型： ULONG

IP 地址有效的最长时间（以秒为单位）。 0xffffffff 的值被视为无限。

PreferredLifetime

类型： ULONG

IP 地址有效的首选时间（以秒为单位）。 0xffffffff 的值被视为无限。

OnLinkPrefixLength

类型： UINT8

IP 地址的前缀或网络部分的长度（以位为单位）。 对于单播 IPv4 地址，任何大于 32 的值都是非法值。 对于单播 IPv6 地址，任何大于 128 的值都是非法值。 值 255 通常用于表示非法值。

SkipAsSource

类型： BOOLEAN

此成员指定该地址是否可用作 IP 源地址。

DadState

类型： NL_DAD_STATE

重复的地址检测 (DAD) 状态。 重复地址检测同时适用于 IPv6 和 IPv4 地址。 此成员可以是 Nldef.h 头文件中定义的 NL_DAD_STATE 枚举类型的值之一。

值 含义
IpDadStateInvalid
0
 DAD 状态无效。
IpDadStateTentative
1
 DAD 状态为暂定状态。
IpDadStateDuplicate
2
 检测到重复的 IP 地址。
IpDadStateDeprecated
3
 IP 地址已弃用。
IpDadStatePreferred
4
 IP 地址是首选地址。

ScopeId

类型： SCOPE_ID

IP 地址的范围 ID。 此成员仅适用于 IPv6 地址。 无法设置此成员。 它由添加地址的接口自动确定。

CreationTimeStamp

类型： LARGE_INTEGER

创建 IP 地址时的时间戳。

注解

MIB_UNICASTIPADDRESS_ROW结构在 Windows Vista 及更高版本上定义。

MIB_UNICASTIPADDRESS_ROW 结构的 SkipAsSource 成员会影响 Windows 套接字中 getaddrinfo、GetAddrInfoW 和 GetAddrInfoEx 函数的操作。 如果传递给 getaddrinfo 或 GetAddrInfoW 函数的 pNodeName 参数或传递给 GetAddrInfoEx 函数的 pName 参数指向计算机名称，则返回可用作源地址的计算机的所有永久地址。 在 Windows Vista 及更高版本中，这些地址将包括 GetUnicastIpAddressTable 或 GetUnicastIpAddressEntry 函数返回的所有单播 IP 地址，其中 SkipAsSource 成员在 MIB_UNICASTIPADDRESS_ROW 结构中设置为 false。

如果 pNodeName 或 pName 参数引用群集虚拟服务器名称，则仅返回虚拟服务器地址。 在 Windows Vista 及更高版本上，这些地址将包括 GetUnicastIpAddressTable 或 GetUnicastIpAddressEntry 函数返回的所有单播 IP 地址，其中 SkipAsSource 成员在 MIB_UNICASTIPADDRESS_ROW 结构中设置为 true。 有关聚类分析的详细信息，请参阅 Windows 群集。

具有 Service Pack 1 的 Windows 7 (SP1) 和 Windows Server 2008 R2 with Service Pack 1 (SP1) 为 Netsh.exe 添加在 IP 地址上设置 SkipAsSource 属性的支持。 此修补程序还会更改行为，以便如果 MIB_UNICASTIPADDRESS_ROW 结构中的 SkipAsSource 成员设置为 false，则会在 DNS 中注册 IP 地址。 如果 SkipAsSource 成员设置为 true，则不会在 DNS 中注册 IP 地址。

修补程序适用于 Windows 7 和 Windows Server 2008 R2，它增加了对 Netsh.exe 在 IP 地址上设置 SkipAsSource 属性的支持。 此修补程序还会更改行为，以便如果 MIB_UNICASTIPADDRESS_ROW 结构中的 SkipAsSource 成员设置为 false，则会在 DNS 中注册 IP 地址。 如果 SkipAsSource 成员设置为 true，则不会在 DNS 中注册 IP 地址。 有关详细信息，请参阅知识库 (知识库) 2386184。

Service Pack 2 (SP2) Windows Vista 和 Windows Server 2008 Service Pack 2 (SP2) 也提供了类似的修补程序，为 Netsh.exe 在 IP 地址上设置 SkipAsSource 属性添加了支持。 此修补程序还会更改行为，使得如果 MIB_UNICASTIPADDRESS_ROW 结构中的 SkipAsSource 成员设置为 false，则会在 DNS 中注册 IP 地址。 如果 SkipAsSource 成员设置为 true，则不会在 DNS 中注册 IP 地址。

示例

以下示例检索单播 IP 地址表，并打印每个检索 到MIB_UNICASTIPADDRESS_ROW 结构中的一些值。


#ifndef UNICODE
#define UNICODE
#endif

#ifndef WIN32_LEAN_AND_MEAN
#define WIN32_LEAN_AND_MEAN
#endif

#include <Windows.h.>
#include <winsock2.h>
#include <ws2tcpip.h>
#include <ws2ipdef.h>
#include <iphlpapi.h>
#include <stdio.h>
#include <stdlib.h>

// Need to link with Iphlpapi.lib and Ws2_32.lib
#pragma comment (lib, "iphlpapi.lib")
#pragma comment (lib, "Ws2_32.lib")

int __cdecl wmain()
{

    // Declare and initialize variables

    unsigned int i;

    DWORD Result = 0;

    WCHAR Ipv4String[16] = { 0 };
    WCHAR Ipv6String[46] = { 0 };

    PMIB_UNICASTIPADDRESS_TABLE pipTable = NULL;

    Result = GetUnicastIpAddressTable(AF_UNSPEC, &pipTable);
    if (Result != NO_ERROR) {
        wprintf(L"GetUnicastIpAddressTable returned error: %ld\n", Result);
        exit(1);
    }
    // Print some variables from the rows in the table
    wprintf(L"Number of table entries: %d\n\n", pipTable->NumEntries);

    for (i = 0; i < pipTable->NumEntries; i++) {
        wprintf(L"AddressFamily[%d]:\t\t ", i);

        switch (pipTable->Table[i].Address.si_family) {
        case AF_INET:
            wprintf(L"IPv4\n");
            if (InetNtopW
                (AF_INET, &pipTable->Table[i].Address.Ipv4.sin_addr, Ipv4String,
                 16) != NULL)
                wprintf(L"IPv4 Address:\t\t\t %ws\n", Ipv4String);
            break;
        case AF_INET6:
            wprintf(L"IPv6\n");
            if (InetNtopW
                (AF_INET6, &pipTable->Table[i].Address.Ipv6.sin6_addr,
                 Ipv6String, 46) != NULL)
                wprintf(L"IPv6 Address:\t\t\t %ws\n", Ipv6String);
            break;
        default:
            wprintf(L"Other: %d\n", pipTable->Table[i].Address.si_family);
            break;
        }

        wprintf(L"Interface LUID NetLuidIndex[%d]:  %lu\n",
               i, pipTable->Table[i].InterfaceLuid.Info.NetLuidIndex);
        wprintf(L"Interface LUID IfType[%d]:\t ", i);
        switch (pipTable->Table[i].InterfaceLuid.Info.IfType) {
        case IF_TYPE_OTHER:
            wprintf(L"Other\n");
            break;
        case IF_TYPE_ETHERNET_CSMACD:
            wprintf(L"Ethernet\n");
            break;
        case IF_TYPE_ISO88025_TOKENRING:
            wprintf(L"Token ring\n");
            break;
        case IF_TYPE_PPP:
            wprintf(L"PPP\n");
            break;
        case IF_TYPE_SOFTWARE_LOOPBACK:
            wprintf(L"Software loopback\n");
            break;
        case IF_TYPE_ATM:
            wprintf(L"ATM\n");
            break;
        case IF_TYPE_IEEE80211:
            wprintf(L"802.11 wireless\n");
            break;
        case IF_TYPE_TUNNEL:
            wprintf(L"Tunnel encapsulation\n");
            break;
        case IF_TYPE_IEEE1394:
            wprintf(L"IEEE 1394 (Firewire)\n");
            break;
        default:
            wprintf(L"Unknown: %d\n",
                   pipTable->Table[i].InterfaceLuid.Info.IfType);
            break;
        }

        wprintf(L"Interface Index[%d]:\t\t %lu\n",
               i, pipTable->Table[i].InterfaceIndex);

        wprintf(L"Prefix Origin[%d]:\t\t ", i);
        switch (pipTable->Table[i].PrefixOrigin) {
        case IpPrefixOriginOther:
            wprintf(L"IpPrefixOriginOther\n");
            break;
        case IpPrefixOriginManual:
            wprintf(L"IpPrefixOriginManual\n");
            break;
        case IpPrefixOriginWellKnown:
            wprintf(L"IpPrefixOriginWellKnown\n");
            break;
        case IpPrefixOriginDhcp:
            wprintf(L"IpPrefixOriginDhcp\n");
            break;
        case IpPrefixOriginRouterAdvertisement:
            wprintf(L"IpPrefixOriginRouterAdvertisement\n");
            break;
        case IpPrefixOriginUnchanged:
            wprintf(L"IpPrefixOriginUnchanged\n");
            break;
        default:
            wprintf(L"Unknown: %d\n", pipTable->Table[i].PrefixOrigin);
            break;
        }

        wprintf(L"Suffix Origin[%d]:\t\t ", i);
        switch (pipTable->Table[i].SuffixOrigin) {
        case IpSuffixOriginOther:
            wprintf(L"IpSuffixOriginOther\n");
            break;
        case IpSuffixOriginManual:
            wprintf(L"IpSuffixOriginManual\n");
            break;
        case IpSuffixOriginWellKnown:
            wprintf(L"IpSuffixOriginWellKnown\n");
            break;
        case IpSuffixOriginDhcp:
            wprintf(L"IpSuffixOriginDhcp\n");
            break;
        case IpSuffixOriginLinkLayerAddress:
            wprintf(L"IpSuffixOriginLinkLayerAddress\n");
            break;
        case IpSuffixOriginRandom:
            wprintf(L"IpSuffixOriginRandom\n");
            break;
        case IpSuffixOriginUnchanged:
            wprintf(L"IpSuffixOriginUnchanged\n");
            break;
        default:
            wprintf(L"Unknown: %d\n", pipTable->Table[i].SuffixOrigin);
            break;
        }

        wprintf(L"Valid Lifetime[%d]:\t\t 0x%x (%u)\n", i,
               pipTable->Table[i].ValidLifetime,
               pipTable->Table[i].ValidLifetime);

        wprintf(L"Preferred Lifetime[%d]:\t\t 0x%x (%u)\n", i,
               pipTable->Table[i].PreferredLifetime,
               pipTable->Table[i].PreferredLifetime);

        wprintf(L"OnLink PrefixLength[%d]:\t\t %lu\n", i,
               pipTable->Table[i].OnLinkPrefixLength);

        wprintf(L"Skip As Source[%d]:\t\t ", i);
        if (pipTable->Table[i].SkipAsSource)
            wprintf(L"Yes\n");
        else
            wprintf(L"No\n");

        wprintf(L"Dad State[%d]:\t\t\t ", i);
        switch (pipTable->Table[i].DadState) {
        case IpDadStateInvalid:
            wprintf(L"IpDadStateInvalid\n");
            break;
        case IpDadStateTentative:
            wprintf(L"IpDadStateTentative\n");
            break;
        case IpDadStateDuplicate:
            wprintf(L"IpDadStateDuplicate\n");
            break;
        case IpDadStateDeprecated:
            wprintf(L"IpDadStateDeprecated\n");
            break;
        case IpDadStatePreferred:
            wprintf(L"IpDadStatePreferred\n");
            break;
        default:
            wprintf(L"Unknown: %d\n", pipTable->Table[i].DadState);
            break;
        }

        wprintf(L"\n");
    }

    if (pipTable != NULL) {
        FreeMibTable(pipTable);
        pipTable = NULL;
    }

    exit(0);
}

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 netioapi.h (包括 Iphlpapi.h)

另请参阅

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetAddrInfoEx

GetAddrInfoW

GetUnicastIpAddressEntry

GetUnicastIpAddressTable

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_TABLE

SOCKADDR_INET

SetUnicastIpAddressEntry

getaddrinfo