GetBestRoute 関数 (iphlpapi.h)

  • [アーティクル]

GetBestRoute 関数は、指定された宛先 IP アドレスへの最適なルートを取得します。

構文

IPHLPAPI_DLL_LINKAGE DWORD GetBestRoute(
  [in]  DWORD             dwDestAddr,
  [in]  DWORD             dwSourceAddr,
  [out] PMIB_IPFORWARDROW pBestRoute
);

パラメーター

[in] dwDestAddr

最適なルートを取得する宛先 IP アドレス。

[in] dwSourceAddr

送信元 IP アドレス。 この IP アドレスは、ローカル コンピューター上のインターフェイスに対応します。 宛先アドレスへの最適なルートが複数存在する場合、関数はこのインターフェイスを使用するルートを選択します。

このパラメーターは省略可能です。 呼び出し元は、このパラメーターに 0 を指定できます。

[out] pBestRoute

dwDestAddr で指定された IP アドレスに最適なルートを含むMIB_IPFORWARDROW構造体へのポインター。

戻り値

関数が成功した場合、戻り値はNO_ERROR。

関数が失敗した場合は、 FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー iphlpapi.h
Library Iphlpapi.lib
[DLL] Iphlpapi.dll

関連項目

GetBestInterface

IP ヘルパー関数リファレンス

IP ヘルパーの開始ページ

MIB_IPFORWARDROW