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。

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

備註

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

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

規格需求

另請參閱

RtmCreateRouteList

RtmDeleteRouteList