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 |
程式庫 | Rtm.lib |
Dll | Rtm.dll |