GetBestInterface

GetBestInterface 関数は、指定した IPv4 アドレスに対する最適経路を持つインターフェイスのインデックスを取得する。

GetBestInterface dwDestAddr, pdwBestIfIndex

dwDestAddr : [int] 最適経路を持つインターフェイスを取得する対象の宛先 IPv4 アドレス (IPAddr 形式)。
pdwBestIfIndex : [var] dwDestAddr で指定した IPv4 アドレスに対して最適経路を持つインターフェイスのインデックスを受け取る DWORD 変数へのポインタ。

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

解説

GetBestInterface 関数は、指定した IPv4 アドレスに対する最適経路を持つインターフェイスのインデックスを取得する。

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

[備考]
GetBestInterface 関数は IPv4 アドレスのみに対応する。IPv6 アドレスには GetBestInterfaceEx
を使う。IPAddr データ型については Windows Data Types を参照。ドット区切り十進表記と IPAddr
形式の変換には inet_addr / inet_ntoa を使う。Windows Vista 以降では、pdwBestIfIndex は
IP Helper 内部で NET_IFINDEX 型ポインタとして扱われる。

情報

プラグイン / モジュールiphlpapi.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の iphlpapi.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_iphlpapi_gen2.hs