Funzione RtmEnumerateGetNextRoute

[Questa API è stata sostituita dall'API Gestione tabelle di routing versione 2 e non sarà disponibile oltre Windows Server 2003. Le applicazioni devono usare l'API Gestione tabelle di routing versione 2.

La funzione RtmEnumerateGetNextRoute restituisce la voce di route successiva dell'enumerazione avviata da una chiamata a RtmCreateEnumerationHandle.

Sintassi

DWORD RtmEnumerateGetNextRoute(
  _In_  HANDLE EnumerationHandle,
  _Out_ PVOID  Route
);

Parametri

EnumerazioneHandle [in]

Handle che identifica l'enumerazione e specifica il relativo ambito. Ottenere questo handle chiamando RtmCreateEnumerationHandle.

Route [out]

Puntatore a una struttura di route specifica della famiglia di protocolli ( RTM_IP_ROUTE o RTM_IPX_ROUTE). Questa struttura riceverà la route successiva nell'enumerazione.

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	Descrizione
ERROR_INVALID_HANDLE	Il parametro EnumerationHandle non è valido.
ERROR_NO_MORE_ROUTES	Nell'enumerazione non sono presenti più route.
ERROR_NO_SYSTEM_RESOURCES	Esistono risorse insufficienti per eseguire l'operazione.

Commenti

Anche se le route non vengono restituite in alcun ordine specifico, ogni route nell'enumerazione viene restituita una sola volta.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Fine del supporto server	Windows Server 2003
Intestazione	Rtm.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

Informazioni di riferimento su Gestione tabelle di routing versione 1

Funzioni di Gestione tabelle di routing versione 1

RTM_IP_ROUTE

RTM_IPX_ROUTE

RtmCloseEnumerationHandle

RtmCreateEnumerationHandle