RtmGetEnumNextHops 函式 (rtmv2.h)

RtmGetEnumNextHops 函式會擷取指定列舉中的下一組下一個躍點。

語法

DWORD RtmGetEnumNextHops(
  [in]      RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]      RTM_ENUM_HANDLE     EnumHandle,
  [in, out] PUINT               NumNextHops,
  [out]     PRTM_NEXTHOP_HANDLE NextHopHandles
);

參數

[in] RtmRegHandle

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

[in] EnumHandle

下一個躍點列舉的句柄。

[in, out] NumNextHops

輸入時， NumNextHops 是 UINT 值的指標，指定 NextHopHandles 可接收的下一個躍點數目上限。

輸出時， NumNextHops 會接收 NextHopHandles 所收到的下一個躍點的實際數目。

[out] NextHopHandles

在輸入時， NextHopHandles 指向 RTM_NEXTHOP_INFO 結構的指標。

在輸出上， NextHopHandles 會收到下一個躍點的句柄數位。

傳回值

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

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

值	意義
ERROR_INVALID_PARAMETER	NumRoutes 所指向的值大於用戶端允許使用一個呼叫擷取的路由數目上限。 檢查 RTM_REGN_PROFILE 是否有允許用戶端擷取一個呼叫的下一個躍點數目上限。
ERROR_NO_MORE_ITEMS	沒有其他要列舉的下一個躍點。

 

 

備註

當不再需要下一個躍點時，請呼叫 RtmReleaseNextHops 加以釋放。

規格需求

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

另請參閱

RtmCreateNextHopEnum

RtmDeleteEnumHandle

RtmReleaseNextHops