Compartir a través de

Función RtmInsertInRouteList (rtmv2.h)

  • Artículo

La función RtmInsertInRouteList inserta el conjunto especificado de rutas en la lista de rutas del cliente. Si una ruta ya está en otra lista, la ruta se quita de la lista anterior y se inserta en la nueva.

Sintaxis

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

Parámetros

[in] RtmRegHandle

Identificador del cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] RouteListHandle

Controle la lista de rutas a la que se van a agregar rutas. Especifique NULL para quitar las rutas especificadas de sus listas antiguas.

[in] NumRoutes

Especifica el número de rutas en RouteHandles.

[in] RouteHandles

Puntero a una matriz de identificadores de ruta para pasar de la lista anterior a la nueva lista.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Valor Significado
ERROR_INVALID_HANDLE
 El identificador no es válido.

Comentarios

Cuando las rutas ya no sean necesarias, liberelas llamando a RtmReleaseRoutes.

Para obtener código de ejemplo con esta función, consulte Uso de una lista de rutas de Client-Specific.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rtmv2.h
Library Rtm.lib
Archivo DLL Rtm.dll

Consulte también

RtmCreateRouteList

RtmDeleteRouteList