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。

如果函式失敗,傳回值就是下列其中一個錯誤碼。

意義
ERROR_ACCESS_DENIED
呼叫用戶端不會擁有這個下一個躍點。
ERROR_INVALID_HANDLE
控制代碼無效。
 
 

備註

客戶端應該只使用此指標進行唯讀存取。

當不再需要下一個躍點句柄時,請呼叫 RtmReleaseNextHopInfo 加以釋放。

規格需求

需求
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 rtmv2.h
程式庫 Rtm.lib
Dll Rtm.dll

另請參閱

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmFindNextHop

RtmLockNextHop