GetUnicastIpAddressEntry

ローカルコンピュータ上の既存のユニキャスト IP アドレスエントリの情報を取得する。

GetUnicastIpAddressEntry Row

Row : [var] ユニキャスト IP アドレスエントリの MIB_UNICASTIPADDRESS_ROW 構造体エントリへのポインタ。正常終了時、この構造体は既存のユニキャスト IP アドレスのプロパティで更新される。

(プラグイン / モジュール : iphlpapi.dll)

解説

ローカルコンピュータ上の既存のユニキャスト IP アドレスエントリの情報を取得する。

[戻り値]
関数が成功すると、戻り値は NO_ERROR である。失敗した場合は以下のエラーコードのいずれかが返される。
このドキュメントは省略されている。

[備考]
GetUnicastIpAddressEntry 関数は Windows Vista 以降で定義される。通常は、変更対象の既存の
MIB_UNICASTIPADDRESS_ROW を取得するために使用される。アプリケーションは変更したい
MIB_UNICASTIPADDRESS_ROW のメンバを書き換え、続いて SetUnicastIpAddressEntry
関数を呼び出す。入力時、Row が指す MIB_UNICASTIPADDRESS_ROW 構造体の Address
メンバは有効なユニキャスト IPv4 または IPv6 アドレスで初期化しなければならない。Address 内の
SOCKADDR_INET 構造体の si_family メンバは AF_INET または AF_INET6 に初期化し、対応する
Ipv4 または Ipv6 メンバを有効なユニキャスト IP アドレスに設定する。さらに Row の InterfaceLuid または
InterfaceIndex のいずれかを初期化する必要がある。フィールドは列挙順に使用される。すなわち InterfaceLuid
が指定されていればそれで、0 ならば InterfaceIndex
でインターフェイスを決定する。呼び出しが成功すると、GetUnicastIpAddressEntry はユニキャスト IP
アドレスの他のプロパティを取得し Row の MIB_UNICASTIPADDRESS_ROW
を埋める。ローカルコンピュータ上のユニキャスト IP アドレスエントリの列挙には GetUnicastIpAddressTable
を使用できる。

情報