RtmGetNextHopPointer 関数 (rtmv2.h)
RtmGetNextHopPointer 関数は、指定された次ホップへの直接ポインターを取得します。 ポインターを使用すると、次ホップ所有者はルーティング テーブル マネージャーの RTM_NEXTHOP_INFO 構造に直接読み取りアクセスできます。
構文
DWORD RtmGetNextHopPointer(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_NEXTHOP_HANDLE NextHopHandle,
[out] PRTM_NEXTHOP_INFO *NextHopPointer
);
パラメーター
[in] RtmRegHandle
RtmRegisterEntity の以前の呼び出しから取得したクライアントへのハンドル。
[in] NextHopHandle
次ホップにハンドルします。
[out] NextHopPointer
クライアントが次ホップの所有者である場合、 NextHopPointer は次ホップへのポインターを受け取ります。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
| 値 | 意味 |
|---|---|
|
呼び出し元のクライアントは、この次ホップを所有していません。 |
|
ハンドルが正しくありません。 |
注釈
クライアントは、このポインターを読み取り専用アクセスにのみ使用する必要があります。
次ホップ ハンドルが不要になったら、 RtmReleaseNextHopInfo を呼び出して解放します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | rtmv2.h |
| Library | Rtm.lib |
| [DLL] | Rtm.dll |