RtmEnumerateGetNextRoute 函式

[路由 表管理員第 2 版 API 已取代此 API,且無法超過 Windows Server 2003。 應用程式應該使用路由表管理員第 2 版 API。]

RtmEnumerateGetNextRoute函式會傳回列舉中由呼叫 RtmCreateEnumerationHandle 開始的下一個路由專案。

語法

DWORD RtmEnumerateGetNextRoute(
  _In_  HANDLE EnumerationHandle,
  _Out_ PVOID  Route
);

參數

EnumerationHandle [in]

識別列舉並指定其範圍的控制碼。 呼叫 RtmCreateEnumerationHandle以取得此控制碼。

路由 [out]

通訊協定系列特定路由結構的指標 ( RTM_IP_ROUTERTM_IPX_ROUTE) 。 這個結構將會在列舉中接收下一個路由。

傳回值

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

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

Description
ERROR_INVALID_HANDLE
EnumerationHandle參數無效。
ERROR_NO_MORE_ROUTES
列舉中沒有更多路由。
ERROR_NO_SYSTEM_RESOURCES
資源不足,無法執行作業。

備註

雖然路由不會以任何特定順序傳回,但列舉中的每個路由只會傳回一次。

規格需求

需求
最低支援的用戶端
都不支援
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
伺服器終止支援
Windows Server 2003
標頭
Rtm.h
程式庫
Rtm.lib
DLL
Rtm.dll

另請參閱

路由表管理員第 1 版參考

路由表管理員第 1 版函式

RTM_IP_ROUTE

RTM_IPX_ROUTE

RtmCloseEnumerationHandle

RtmCreateEnumerationHandle