GetAdaptersInfo

GetAdaptersInfo 関数は、ローカルコンピュータのアダプタ情報を取得する。

GetAdaptersInfo AdapterInfo, SizePointer

AdapterInfo : [var] IP_ADAPTER_INFO 構造体の連結リストを受け取るバッファへのポインタ。
SizePointer : [var] pAdapterInfo が指すバッファのサイズ (ULONG) へのポインタ。アダプタ情報を格納するには不十分な場合、必要サイズが書き込まれ ERROR_BUFFER_OVERFLOW が返される。

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

解説

GetAdaptersInfo 関数は、ローカルコンピュータのアダプタ情報を取得する。

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

[備考]
GetAdaptersInfo 関数は IPv4 アドレスの情報のみを取得できる。Windows 10
より前ではアダプタ順序はネットワーク接続フォルダの詳細設定から制御できたが、Windows 10
以降では順序は未規定。GetAdaptersInfo と GetInterfaceInfo は IPv4
ループバックインターフェイスの情報を返さない。ループバックの情報は GetIpAddrTable で取得する。Windows XP
以降では、GetAdaptersInfo の返すアダプタリストに単方向アダプタも含まれる。送受信両方可能なアダプタ一覧を得るには
GetUniDirectionalAdapterInfo を呼んで除外すればよい。

情報