RtmFindNextHop 函式 (rtmv2.h)
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。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
呼叫客戶端沒有擁有這個下一個躍點。 |
|
找不到指定的下一個躍點。 |
備註
只要用戶端尚未發行 NextHopHandle，NextHopPointer 就有效。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | rtmv2.h |
| 程式庫 | Rtm.lib |
| Dll | Rtm.dll |