RtmFindNextHop 函式 (rtmv2.h)

發行項
03/01/2024

RtmFindNextHop 函式會在用戶端的下一個躍點清單中尋找特定的下一個躍點。

語法

DWORD RtmFindNextHop(
  [in]  RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]  PRTM_NEXTHOP_INFO   NextHopInfo,
  [out] PRTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO   *NextHopPointer
);

參數

[in] RtmRegHandle

從先前呼叫 RtmRegisterEntity 取得的用戶端句柄。

[in] NextHopInfo

RTM_NEXTHOP_INFO 結構的指標，其中包含識別要尋找之下一個躍點的資訊。使用 NextHopAddress 和 InterfaceIndex 成員來識別要尋找的下一個躍點。

[out] NextHopHandle

如果必須傳回句柄：輸入時， NextHopPointer 是 NULL 的指標。輸出時，如果客戶端擁有下一個躍點， NextHopPointer 會收到下一個躍點句柄的指標;否則， NextHopPointer 會保持不變。

如果不需要傳回句柄：在輸入時， NextHopPointer 為 NULL。

[out] NextHopPointer

如果必須傳回指標：輸入時， NextHopPointer 是 NULL 的指標。在輸出上，如果客戶端擁有下一個躍點， NextHopPointer 會收到下一個躍點的指標;否則， NextHopPointer 會保持不變。

如果不需要傳回指標：輸入時， NextHopPointer 為 NULL。

傳回值

如果函式成功，傳回值會NO_ERROR。

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

值	意義
ERROR_ACCESS_DENIED	呼叫客戶端沒有擁有這個下一個躍點。
ERROR_NOT_FOUND	找不到指定的下一個躍點。

備註

只要用戶端尚未發行 NextHopHandle，NextHopPointer 就有效。

規格需求

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