RtmLockNextHop 関数 (rtmv2.h)
RtmLockNextHop 関数は、次ホップをロックまたはロック解除します。 この関数は、次ホップに変更を加える前に、次ホップの所有者が次ホップをロックするために呼び出す必要があります。 次ホップへのポインターが返されます。
構文
DWORD RtmLockNextHop(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_NEXTHOP_HANDLE NextHopHandle,
[in] BOOL Exclusive,
[in] BOOL LockNextHop,
[out] PRTM_NEXTHOP_INFO *NextHopPointer
);
パラメーター
[in] RtmRegHandle
RtmRegisterEntity の以前の呼び出しから取得したクライアントへのハンドル。
[in] NextHopHandle
ロックまたはロック解除を行う次ホップを処理します。
[in] Exclusive
排他 (TRUE) モードまたは共有 (FALSE) モードで次ホップをロックまたはロック解除するかどうかを指定します。
[in] LockNextHop
次ホップをロックするかロック解除するかを指定します。 TRUE を指定して次ホップをロックします。FALSE を指定してロックを解除します。
[out] NextHopPointer
入力時、 NextHopPointer は NULL へのポインターです。
出力時に、クライアントが次ホップを所有している場合、 NextHopPointer は 次ホップへのポインターを受け取ります。それ以外の場合、 NextHopPointer は変更されません。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
値 | 意味 |
---|---|
|
呼び出し元のクライアントは、この次ホップを所有していません。 |
|
指定された次ホップが見つかりませんでした。 |
注釈
クライアントは、RTM_NEXTHOP_INFO構造体の NextHopAddress メンバーと InterfaceIndex メンバーを変更できません。これらの値は、次ホップを一意に識別するために使用されます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | rtmv2.h |
Library | Rtm.lib |
[DLL] | Rtm.dll |