Compartir a través de

Función RtmGetEnumNextHops (rtmv2.h)

  • Artículo

La función RtmGetEnumNextHops recupera el siguiente conjunto de próximo saltos en la enumeración especificada.

Sintaxis

DWORD RtmGetEnumNextHops(
  [in]      RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]      RTM_ENUM_HANDLE     EnumHandle,
  [in, out] PUINT               NumNextHops,
  [out]     PRTM_NEXTHOP_HANDLE NextHopHandles
);

Parámetros

[in] RtmRegHandle

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

[in] EnumHandle

Identificador de la enumeración de próximo salto.

[in, out] NumNextHops

En la entrada, NumNextHops es un puntero a un valor UINT que especifica el número máximo de próximo saltos que NextHopHandles puede recibir.

En la salida, NumNextHops recibe el número real de próximo saltos recibidos por NextHopHandles.

[out] NextHopHandles

En la entrada, los punteros NextHopHandles a una estructura de RTM_NEXTHOP_INFO .

En la salida, NextHopHandles recibe una matriz de identificadores a los próximo saltos.

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_INVALID_PARAMETER
 El valor al que apunta NumRoutes es mayor que el número máximo de rutas que un cliente puede recuperar con una llamada. Compruebe RTM_REGN_PROFILE el número máximo de próximo saltos que el cliente puede recuperar con una llamada.
ERROR_NO_MORE_ITEMS
 No hay más saltos para enumerar.
 
 

Comentarios

Cuando ya no se necesiten los próximo saltos, ábralos llamando a RtmReleaseNextHops.

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

RtmCreateNextHopEnum

RtmDeleteEnumHandle

RtmReleaseNextHops