GetUnicastIpAddressTable

ローカルコンピュータ上のユニキャスト IP アドレステーブルを取得する。

GetUnicastIpAddressTable Family, Table

Family : [int] 取得するアドレスファミリ。アドレスファミリの値は Winsock2.h ヘッダで定義される。AF_ と PF_ の定数は等価 (例: AF_INET と PF_INET) であり、どちらを使っても構わない。Windows Vista 以降向けの Windows SDK ではヘッダ構成が変更され、これらの値は Ws2def.h で定義される。Ws2def.h は Winsock2.h から自動的にインクルードされるので、直接インクルードしてはならない。現在サポートされる値は AF_INET、AF_INET6、AF_UNSPEC である。
Table : [var] ローカルコンピュータ上のユニキャスト IP アドレスエントリのテーブルを格納する MIB_UNICASTIPADDRESS_TABLE 構造体へのポインタ。

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

解説

ローカルコンピュータ上のユニキャスト IP アドレステーブルを取得する。

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

[備考]
GetUnicastIpAddressTable 関数は Windows Vista 以降で定義される。ローカルシステム上のユニキャスト
IP アドレスを列挙し、MIB_UNICASTIPADDRESS_TABLE 構造体で返す。この構造体はエントリ数と、各ユニキャスト IP
アドレスエントリに対応する MIB_UNICASTIPADDRESS_ROW の配列を含む。返された構造体が不要になった場合は
FreeMibTable でメモリを解放する。Family は AF_INET、AF_INET6、AF_UNSPEC
のいずれかで初期化しなければならない。なお返される MIB_UNICASTIPADDRESS_TABLE では、NumEntries
メンバと Table の最初の MIB_UNICASTIPADDRESS_ROW
エントリとの間、さらにエントリ間にもアライメントのためのパディングが存在しうるので、配列要素アクセス時はパディングを考慮すること。

情報