RtmDeleteNextHop 関数 (rtmv2.h)

RtmDeleteNextHop 関数は、次ホップリストから次ホップを削除します。

構文

DWORD RtmDeleteNextHop(
  [in] RTM_ENTITY_HANDLE  RtmRegHandle,
  [in] RTM_NEXTHOP_HANDLE NextHopHandle,
  [in] PRTM_NEXTHOP_INFO  NextHopInfo
);

[in] RtmRegHandle

RtmRegisterEntity の以前の呼び出しから取得したクライアントへのハンドル。

[in] NextHopHandle

削除する次ホップを処理します。このパラメーターは省略可能であり、 NULL に設定できます。 NULL の場合は、 NextHopInfo の値を使用して、削除する次ホップを識別します。

[in] NextHopInfo

削除する次ホップを識別する情報を含む構造体へのポインター。このパラメーターは省略可能であり、 NULL に設定できます。 NULL の場合は、 NextHopHandle のハンドルを使用して、削除する次ホップを識別します。

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

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

値	説明
ERROR_ACCESS_DENIED	呼び出し元のクライアントは、この次ホップを所有していません。
ERROR_NOT_ENOUGH_MEMORY	この操作を完了するのに十分なメモリがありません。
ERROR_NOT_FOUND	指定された次ホップが見つかりませんでした。

クライアントで NextHopHandle が指定されている場合、その後、クライアントは RtmReleaseNextHops を使用してハンドルを解放しないでください。