GetBestInterfaceEx

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

GetBestInterfaceEx pDestAddr, pdwBestIfIndex

pDestAddr : [var] 最適経路を持つインターフェイスを取得する対象の宛先 IPv6 / IPv4 アドレス (sockaddr 構造体形式)。
pdwBestIfIndex : [var] pDestAddr で指定した IPv6 / IPv4 アドレスに対して最適経路を持つインターフェイスのインデックスへのポインタ。

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

解説

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

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

[備考]
GetBestInterfaceEx 関数は GetBestInterface と異なり IPv4 / IPv6
両方に使用できる。pDestAddr が指す sockaddr 構造体の Family メンバは AF_INET または AF_INET6
のいずれかに設定する必要がある。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