IP_ADAPTER_UNICAST_ADDRESS_LH結構 (iptypes.h)
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 位址在 DNS 中是合法的。 |
|
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 通常用來表示不合法的值。
備註
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) |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應