GetInterfaceInfo

GetInterfaceInfo 関数は、ローカルシステムで IPv4 が有効なネットワークインターフェイスアダプタ一覧を取得する。

GetInterfaceInfo pIfTable, dwOutBufLen

pIfTable : [var] アダプタ一覧を受け取る IP_INTERFACE_INFO 構造体を指定するバッファへのポインタ。呼び出し元がバッファを確保する必要がある。
dwOutBufLen : [var] pIfTable が指す IP_INTERFACE_INFO 構造体用バッファのサイズを指定する DWORD 変数へのポインタ。IPv4 インターフェイス情報を格納するのに不十分な場合は必要サイズが書き込まれ ERROR_INSUFFICIENT_BUFFER が返される。

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

解説

GetInterfaceInfo 関数は、ローカルシステムで IPv4 が有効なネットワークインターフェイスアダプタ一覧を取得する。

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

[備考]
GetInterfaceInfo 関数は IPv4 が有効なネットワークアダプタに特化している。pIfTable が指す
IP_INTERFACE_INFO 構造体を介して、IPv4 有効ネットワークアダプタの数と IP_ADAPTER_INDEX_MAP
配列を返す。NumAdapters が 0 でも少なくとも 1 つの IP_ADAPTER_INDEX_MAP が返される
(内容は未定義)。バッファが小さすぎると ERROR_INSUFFICIENT_BUFFER が返り、必要サイズが dwOutBufLen
に書き込まれる。正しい使い方は 2 回呼び出す方法で、1 回目は pIfTable に NULL / dwOutBufLen に 0
を渡し、2 回目で取得サイズのバッファを渡す。GetAdaptersInfo / GetInterfaceInfo
はループバックインターフェイスの情報を返さない (GetIpAddrTable で取得する)。Windows Vista 以降では
IP_ADAPTER_INDEX_MAP の Name メンバがネットワークインターフェイス GUID の Unicode 文字列
('{' で始まる) になる場合がある。

情報