次の方法で共有

RtmGetEnumNextHops 関数 (rtmv2.h)

  • [アーティクル]

RtmGetEnumNextHops 関数は、指定された列挙体の次のホップセットを取得します。

構文

DWORD RtmGetEnumNextHops(
  [in]      RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]      RTM_ENUM_HANDLE     EnumHandle,
  [in, out] PUINT               NumNextHops,
  [out]     PRTM_NEXTHOP_HANDLE NextHopHandles
);

パラメーター

[in] RtmRegHandle

RtmRegisterEntity の以前の呼び出しから取得したクライアントを処理します。

[in] EnumHandle

次ホップ列挙を処理します。

[in, out] NumNextHops

入力時、NumNextHops は、NextHopHandles で受信できる次ホップの最大数を指定する UINT 値へのポインターです。

出力時に、 NumNextHops は NextHopHandles によって受信された次ホップの実際の数を受け取ります。

[out] NextHopHandles

入力時に、 NextHopHandles は RTM_NEXTHOP_INFO 構造体へのポインターを指します。

出力時に、 NextHopHandles は次ホップへのハンドルの配列を受け取ります。

戻り値

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

関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。

値 意味
ERROR_INVALID_PARAMETER
 NumRoutes が指す値が、クライアントが 1 回の呼び出しで取得できるルートの最大数を超えています。 RTM_REGN_PROFILE、クライアントが 1 回の呼び出しで取得できるネクスト ホップの最大数を確認します。
ERROR_NO_MORE_ITEMS
 列挙する次ホップはこれ以上ありません。
 
 

注釈

次ホップが不要になったら、 RtmReleaseNextHops を呼び出して解放します。

要件

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

こちらもご覧ください

RtmCreateNextHopEnum

RtmDeleteEnumHandle

RtmReleaseNextHops