英語で読む

次の方法で共有


RtmIsRoute 関数

[この API は ルーティング テーブル マネージャー バージョン 2 API に置き換えられているので、Windows Server 2003 以降は使用できません。 アプリケーションでは、ルーティング テーブル マネージャー バージョン 2 API を使用する必要があります。

RtmIsRoute 関数は、指定された宛先ネットワークへの 1 つ以上のルートが存在するかどうかを判断します。 その場合、関数はそのネットワークへの最適なルートの情報を返します。

構文

BOOL RtmIsRoute(
  _In_  DWORD ProtocolFamily,
  _In_  PVOID Network,
  _Out_ PVOID BestRoute
);

パラメーター

ProtocolFamily [in]

Network パラメーターが指すデータ構造の種類 (IP_NETWORKIPX_NETWORKなど) を指定します。

ネットワーク [入力]

プロトコル ファミリ固有のネットワーク番号データを指定する構造体へのポインター。 このデータは、呼び出し元がルート情報をシークするネットワークを識別します。

BestRoute [out]

現在の最適なルート情報 (存在する場合) を受け取るプロトコル ファミリ固有の構造体へのポインター。

戻り値

戻り値は、次のいずれかのコードです。

説明
TRUE
指定されたネットワークへの少なくとも 1 つのルートが存在します。 最適なルートは、 BestRoute パラメーターによって指される構造体で返されます。
FALSE
指定されたネットワークへのルートがないか、操作に失敗しました。 GetLastError を呼び出して、詳細情報を取得します。
NO_ERROR
操作は成功しましたが、指定されたネットワークへのルートはありません。
ERROR_INVALID_PARAMETER
ProtocolFamily パラメーターの値は、インストールされているプロトコル ファミリには対応していません。
ERROR_NO_SYSTEM_RESOURCES
操作を実行するためのリソースが不足しています。

必要条件

要件
サポートされている最小のクライアント
サポートなし
サポートされている最小のサーバー
Windows 2000 Server [デスクトップ アプリのみ]
サーバー サポートの終了
Windows Server 2003
ヘッダー
Rtm.h
ライブラリ
Rtm.lib
[DLL]
Rtm.dll

関連項目

ルーティング テーブル マネージャー バージョン 1 リファレンス

ルーティング テーブル マネージャー バージョン 1 関数

Getlasterror

IP_NETWORK

IPX_NETWORK

RTMv1 プロトコル ファミリ識別子