Compartir a través de

Función RtmCreateNextHopEnum (rtmv2.h)

  • Artículo

RtmCreateNextHopEnum enumera los próximo saltos de la lista de próximo salto.

Sintaxis

DWORD RtmCreateNextHopEnum(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ENUM_FLAGS    EnumFlags,
  [in]  PRTM_NET_ADDRESS  NetAddress,
  [out] PRTM_ENUM_HANDLE  RtmEnumHandle
);

Parámetros

[in] RtmRegHandle

Identificador del cliente obtenido de una llamada anterior a RtmRegisterEntity.

[in] EnumFlags

Especifica los saltos siguientes que se van a incluir en la enumeración . Se usan las marcas siguientes.

Constante Significado
RTM_ENUM_NEXT
 Enumere los saltos siguientes a partir de la longitud especificada de la dirección o máscara (por ejemplo, 10/8). La enumeración continúa hasta el final de la lista de próximo salto.
RTM_ENUM_RANGE
 Enumere los saltos siguientes en el intervalo especificado por la longitud de la dirección o máscara (por ejemplo, 10/8).
RTM_ENUM_START
 Enumerar los próximo saltos a partir del 0/0. Especifique NULL para NetAddress.

[in] NetAddress

Puntero a una estructura RTM_NET_ADDRESS que contiene la dirección inicial de la enumeración. Especifique NULL si EnumFlags contiene RTM_ENUM_START.

[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 RtmGetEnumNextHops, RtmReleaseNextHops y RtmDeleteEnumHandle.

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_PARAMETER
 Un parámetro contiene información incorrecta.
ERROR_NOT_ENOUGH_MEMORY
 No hay suficiente memoria para completar esta operación.
 
 

Comentarios

Si EnumFlags contiene RTM_ENUM_RANGE, use NetAddress para especificar el intervalo de la tabla de enrutamiento que se va a enumerar. Por ejemplo, si un cliente establece NetAddress en 10/8, se devuelven los saltos siguientes del intervalo 10.0.0.0/8 a 10.255.255.255/32.

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

Requisitos

   
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

RTM_NET_ADDRESS

RtmDeleteEnumHandle

RtmGetEnumNextHops

RtmReleaseNextHops