Compartir a través de

Función RtmCreateRouteListEnum (rtmv2.h)

  • Artículo

La función RtmCreateRouteListEnum crea una enumeración de rutas en la lista de rutas especificada.

Sintaxis

DWORD RtmCreateRouteListEnum(
  [in]  RTM_ENTITY_HANDLE     RtmRegHandle,
  [in]  RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [out] PRTM_ENUM_HANDLE      RtmEnumHandle
);

Parámetros

[in] RtmRegHandle

Identificador para el cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] RouteListHandle

Identificador de la lista de rutas para enumerar que se obtiene de una llamada anterior a RtmCreateRouteList.

[out] RtmEnumHandle

En la entrada, RtmEnumHandle es un puntero a NULL.

En la salida, RtmEnumHandle recibe un puntero a un identificador de la enumeración. Use este identificador en todas las llamadas posteriores a funciones que enumeran la lista de rutas.

Valor devuelto

Si la función se ejecuta 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_NOT_ENOUGH_MEMORY
 No hay suficiente memoria para completar esta operación.
 
 

Comentarios

Cuando el identificador de enumeración ya no sea necesario, ábralo llamando a RtmDeleteEnumHandle.

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

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

RtmDeleteEnumHandle

RtmGetListEnumRoutes