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 は、通常、無効な値を表すために使用されます。
解説
IP_ADAPTER_ADDRESSES構造体は、GetAdaptersAddresses 関数によって取得されます。 IP_ADAPTER_ADDRESSES構造体の FirstUnicastAddress メンバーは、IP_ADAPTER_UNICAST_ADDRESS構造体のリンクされたリストへのポインターです。
Windows Vista 以降で 変更されたIP_ADAPTER_UNICAST_ADDRESS 構造体のサイズ。 Length メンバーを使用して、使用されているIP_ADAPTER_UNICAST_ADDRESS構造体のバージョンを決定する必要があります。
Windows Vista 以降の IP_ADAPTER_UNICAST_ADDRESS 構造体のバージョンには、 OnLinkPrefixLength という新しいメンバーが追加されています。
GetAdaptersAddresses 関数と同様の管理機能でこの構造を使用すると、重複するアドレスを含むすべての構成済みアドレスが表示されます。 このような重複するアドレス エントリは、アドレスが静的に構成されている場合に発生する可能性があります。 このようなレポートを使用すると、管理者のトラブルシューティングが容易になります。 DadState メンバーは、このような状況の特定とトラブルシューティングに効果的です。
Windows SDK では、Windows Vista 以降で使用する構造体のバージョンは 、IP_ADAPTER_UNICAST_ADDRESS_LHとして定義されます。 Windows SDK では、Service Pack 1 (SP1) 以降の Windows XP を含む以前のシステムで使用されるこの構造のバージョンは 、IP_ADAPTER_UNICAST_ADDRESS_XPとして定義されます。 ターゲット プラットフォームが Windows Vista 以降 (NTDDI_VERSION >= NTDDI_VISTA、、または WINVER >= 0x0600) の場合にアプリケーションをコンパイルする場合、_WIN32_WINNT >= 0x0600IP_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) では、ヘッダー ファイルのorganizationが変更され、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 (デスクトップ アプリのみ) |
| Header | iptypes.h (Iphlpapi.h を含む) |
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示