共用方式為

RtmCreateNextHopEnum 函式 (rtmv2.h)

  • 發行項

RtmCreateNextHopEnum會列舉下一個躍點清單中的下一個躍點。

語法

DWORD RtmCreateNextHopEnum(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ENUM_FLAGS    EnumFlags,
  [in]  PRTM_NET_ADDRESS  NetAddress,
  [out] PRTM_ENUM_HANDLE  RtmEnumHandle
);

參數

[in] RtmRegHandle

從先前呼叫 RtmRegisterEntity取得的用戶端控制碼。

[in] EnumFlags

指定要包含在列舉中的下一個躍點。 使用下列旗標。

常數 意義
RTM_ENUM_NEXT
 列舉從指定的位址/遮罩長度開始的下一個躍點 (，例如 10/8) 。 列舉會繼續到下一個躍點清單的結尾。
RTM_ENUM_RANGE
 列舉位址/遮罩長度所指定範圍中的下一個躍點 (，例如 10/8) 。
RTM_ENUM_START
 列舉從 0/0 開始的下一個躍點。 針對NetAddress指定Null。

[in] NetAddress

包含列舉起始位址 之RTM_NET_ADDRESS 結構的指標。 如果EnumFlags包含RTM_ENUM_START，請指定Null。

[out] RtmEnumHandle

在輸入時， RtmEnumHandle 是 Null的指標。

在輸出上， RtmEnumHandle 會接收列舉控制碼的指標。 在所有後續對 RtmGetEnumNextHops、 RtmReleaseNextHops和 RtmDeleteEnumHandle的後續呼叫中使用此控制碼。

傳回值

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

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

值 意義
ERROR_INVALID_PARAMETER
 參數包含不正確的資訊。
ERROR_NOT_ENOUGH_MEMORY
 記憶體不足，無法完成這項作業。
 
 

備註

如果 EnumFlags 包含RTM_ENUM_RANGE，請使用 NetAddress 指定要列舉的路由表範圍。 例如，如果用戶端將 NetAddress 設定為 10/8，則會傳回範圍 10.0.0.0/8 的下一個躍點至 10.255.255.255/32。

不再需要列舉控制碼時，請呼叫 RtmDeleteEnumHandle加以釋放。

需求

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

另請參閱

RTM_NET_ADDRESS

RtmDeleteEnumHandle

RtmGetEnumNextHops

RtmReleaseNextHops