Funzione RtmGetEnumNextHops (rtmv2.h)

La funzione RtmGetEnumNextHops recupera il set successivo di hop successivi nell'enumerazione specificata.

Sintassi

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

Parametri

[in] RtmRegHandle

Gestire il client ottenuto da una chiamata precedente a RtmRegisterEntity.

[in] EnumHandle

Gestire l'enumerazione hop successivo.

[in, out] NumNextHops

In input NumNextHops è un puntatore a un valore UINT che specifica il numero massimo di hop successivi che possono essere ricevuti da NextHopHandles.

Nell'output NumNextHops riceve il numero effettivo di hop successivi ricevuti da NextHopHandles.

[out] NextHopHandles

In input , i puntatori NextHopHandles a una struttura RTM_NEXTHOP_INFO .

Nell'output , NextHopHandles riceve una matrice di handle per i hop successivi.

Valore restituito

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

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

Valore	Significato
ERROR_INVALID_PARAMETER	Il valore a cui punta NumRoutes è maggiore del numero massimo di route consentite a un client. Controllare RTM_REGN_PROFILE per il numero massimo di hop successivi che il client può recuperare con una chiamata.
ERROR_NO_MORE_ITEMS	Non sono presenti più hop successivi da enumerare.

 

 

Commenti

Quando gli hop successivi non sono più necessari, rilasciarli chiamando RtmReleaseNextHops.

Requisiti

Requisito	Valore
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

RtmCreateNextHopEnum

RtmDeleteEnumHandle

RtmReleaseNextHops