IP_ADAPTER_UNICAST_ADDRESS_LH結構 (iptypes.h)

發行項
08/24/2023

IP_ADAPTER_UNICAST_ADDRESS結構會將單一單播 IP 位址儲存在特定介面卡的 IP 位址連結清單中。

語法

typedef struct _IP_ADAPTER_UNICAST_ADDRESS_LH {
  union {
    ULONGLONG Alignment;
    struct {
      ULONG Length;
      DWORD Flags;
    };
  };
  struct _IP_ADAPTER_UNICAST_ADDRESS_LH *Next;
  SOCKET_ADDRESS                        Address;
  IP_PREFIX_ORIGIN                      PrefixOrigin;
  IP_SUFFIX_ORIGIN                      SuffixOrigin;
  IP_DAD_STATE                          DadState;
  ULONG                                 ValidLifetime;
  ULONG                                 PreferredLifetime;
  ULONG                                 LeaseLifetime;
  UINT8                                 OnLinkPrefixLength;
} IP_ADAPTER_UNICAST_ADDRESS_LH, *PIP_ADAPTER_UNICAST_ADDRESS_LH;

成員

Alignment

Length

類型： ULONG

這個結構的長度，以位元組為單位。

Flags

類型： DWORD

這個 IP 位址的一組旗標。

下表顯示可能的值。這些常數定義于 Iptypes.h 標頭檔中。

值	意義
IP_ADAPTER_ADDRESS_DNS_ELIGIBLE	IP 位址在 DNS 中是合法的。
IP_ADAPTER_ADDRESS_TRANSIENT	IP 位址是叢集位址，不應供大部分的應用程式使用。

Next

類型：結構_IP_ADAPTER_UNICAST_ADDRESS*

清單中下一個 IP 配接器位址結構的指標。

Address

類型： SOCKET_ADDRESS

這個單播 IP 位址專案的 IP 位址。此成員可以是 IPv6 位址或 IPv4 位址。

PrefixOrigin

類型： IP_PREFIX_ORIGIN

IP 位址的前置詞或網路部分。這個成員可以是iptypes.h標頭檔中所定義IP_PREFIX_ORIGIN列舉類型的其中一個值。

SuffixOrigin

類型： IP_SUFFIX_ORIGIN

IP 位址的尾碼或主機部分。這個成員可以是iptypes.h標頭檔中所定義IP_SUFFIX_ORIGIN列舉類型的其中一個值。

DadState

類型： IP_DAD_STATE

DAD) 狀態 (重複位址偵測。這個成員可以是iptypes.h標頭檔中所定義IP_DAD_STATE列舉類型的其中一個值。重複的位址偵測適用于 IPv4 和 IPv6 位址。

ValidLifetime

類型： ULONG

IP 位址的有效存留期上限，以秒為單位。 0xffffffff的值會被視為無限。

PreferredLifetime

類型： ULONG

IP 位址有效的慣用存留期，以秒為單位。 0xffffffff的值會被視為無限。

LeaseLifetime

類型： ULONG

租用存留期，以秒為單位，IP 位址有效。

OnLinkPrefixLength

類型： UINT8

IP 位址前置詞或網路部分的長度，以位為單位。若為單播 IPv4 位址，任何大於 32 的值都是不合法的值。若為單播 IPv6 位址，任何大於 128 的值都是不合法的值。值 255 通常用來表示不合法的值。

注意此結構成員僅適用于 Windows Vista 和更新版本。

備註

getAdaptersAddresses函式會擷取IP_ADAPTER_ADDRESSES結構。 IP_ADAPTER_ADDRESSES結構的FirstUnicastAddress成員是IP_ADAPTER_UNICAST_ADDRESS結構連結清單的指標。

Windows Vista 和更新版本上 IP_ADAPTER_UNICAST_ADDRESS 結構的大小已變更。長度成員應該用來判斷正在使用哪一個版本的IP_ADAPTER_UNICAST_ADDRESS結構。

Windows Vista 和更新版本上的 IP_ADAPTER_UNICAST_ADDRESS 結構版本已新增下列新成員： OnLinkPrefixLength。

當此結構與 GetAdaptersAddresses 函式和類似的管理功能搭配使用時，會顯示所有已設定的位址，包括重複的位址。當地址以靜態方式設定時，可能會發生這類重複的位址專案。這類報告有助於系統管理員進行疑難排解。 DadState成員在識別和疑難排解這類情況時有效。

在 Windows SDK 中，用於 Windows Vista 和更新版本的結構版本會定義為 IP_ADAPTER_UNICAST_ADDRESS_LH。在 Windows SDK 中，要用於舊版系統上的這個結構版本，包括 Windows XP with Service Pack 1 (SP1) 和更新版本會定義為 IP_ADAPTER_UNICAST_ADDRESS_XP。當編譯應用程式時，如果目標平臺是 Windows Vista，而更新版本 (NTDDI_VERSION >= NTDDI_VISTA 、 _WIN32_WINNT >= 0x0600 或 WINVER >= 0x0600) ， 則IP_ADAPTER_UNICAST_ADDRESS_LH 結構會類型為 IP_ADAPTER_UNICAST_ADDRESS 結構。如果目標平臺不是 Windows Vista 和更新版本，編譯應用程式時 ，IP_ADAPTER_UNICAST_ADDRESS_XP 結構會依 IP_ADAPTER_UNICAST_ADDRESS 結構進行類型定義。

SOCKET_ADDRESS結構用於IP_ADAPTER_UNICAST_ADDRESS結構。在針對 Windows Vista 和更新版本發行的 Microsoft Windows 軟體發展工具組 (SDK) 上，標頭檔的組織已變更，且SOCKET_ADDRESS結構定義在Winsock2.h標頭檔自動包含的Ws2def.h標頭檔中。在 Windows Server 2003 和 Windows XP 發行的平臺軟體發展工具組 (SDK) 上， SOCKET_ADDRESS 結構會在 Winsock2.h 標頭檔中宣告。若要使用IP_ADAPTER_UNICAST_ADDRESS結構，必須在Iphlpapi.h標頭檔之前包含Winsock2.h標頭檔。

需求


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	iptypes.h (包含 Iphlpapi.h)