共用方式為

RtmInsertInRouteList 函式 (rtmv2.h)

  • 發行項

RtmInsertInRouteList 函式會將指定的路由集插入用戶端的路由清單中。 如果路由已經在另一個清單中，則會從舊清單移除路由，並插入新的清單中。

語法

DWORD RtmInsertInRouteList(
  [in] RTM_ENTITY_HANDLE     RtmRegHandle,
  [in] RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [in] UINT                  NumRoutes,
  [in] PRTM_ROUTE_HANDLE     RouteHandles
);

參數

[in] RtmRegHandle

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

[in] RouteListHandle

要新增路由的路由清單句柄。 指定 NULL 以從其舊清單移除指定的路由。

[in] NumRoutes

指定 RouteHandles 中的路由數目。

[in] RouteHandles

要從舊清單移至新清單之路由句柄陣列的指標。

傳回值

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

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

值 意義
ERROR_INVALID_HANDLE
 控制代碼無效。

備註

當不再需要路由時，請藉由呼叫 RtmReleaseRoutes 加以釋放。

如需使用此函式的範例程式代碼，請參閱 使用 Client-Specific 路由清單。

規格需求

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

另請參閱

RtmCreateRouteList

RtmDeleteRouteList