Funzione RtmCreateNextHopEnum (rtmv2.h)

Articolo
03/15/2023

RtmCreateNextHopEnum enumera gli hop successivi nell'elenco hop successivo.

Sintassi

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

Parametri

[in] RtmRegHandle

Handle per il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] EnumFlags

Specifica gli hop successivi da includere nell'enumerazione . Vengono usati i flag seguenti.

Costante	Significato
RTM_ENUM_NEXT	Enumerare gli hop successivi a partire dalla lunghezza di indirizzo/maschera specificata, ad esempio 10/8. L'enumerazione continua fino alla fine dell'elenco hop successivo.
RTM_ENUM_RANGE	Enumerare gli hop successivi nell'intervallo specificato dalla lunghezza dell'indirizzo/maschera , ad esempio 10/8.
RTM_ENUM_START	Enumerare gli hop successivi a partire da 0/0. Specificare NULL per NetAddress.

[in] NetAddress

Puntatore a una struttura RTM_NET_ADDRESS che contiene l'indirizzo iniziale dell'enumerazione. Specificare NULL se EnumFlags contiene RTM_ENUM_START.

[out] RtmEnumHandle

In input , RtmEnumHandle è un puntatore a NULL.

Nell'output RtmEnumHandle riceve un puntatore a un handle per l'enumerazione . Usare questo handle in tutte le chiamate successive a RtmGetEnumNextHops, RtmReleaseNextHops e RtmDeleteEnumHandle.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_PARAMETER	Un parametro contiene informazioni non corrette.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per completare questa operazione.

Commenti

Se EnumFlags contiene RTM_ENUM_RANGE, usare NetAddress per specificare l'intervallo della tabella di routing da enumerare. Ad esempio, se un client imposta NetAddress su 10/8, vengono restituiti hop successivi nell'intervallo 10.0.0.0/8 su 10.255.255.255/32.

Quando l'handle di enumerazione non è più necessario, rilasciarlo chiamando RtmDeleteEnumHandle.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rtmv2.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

Condividi tramite