Funzione RtmIsRoute

[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 RtmIsRoute determina se esistono una o più route a una rete di destinazione specificata. In tal caso, la funzione restituisce informazioni per la route migliore verso tale rete.

Sintassi

BOOL RtmIsRoute(
  _In_  DWORD ProtocolFamily,
  _In_  PVOID Network,
  _Out_ PVOID BestRoute
);

Parametri

ProtocolFamily [in]

Specifica il tipo di struttura dei dati a cui punta il parametro Network , ad esempio IP_NETWORK, IPX_NETWORK.

Rete [in]

Puntatore a una struttura che specifica i dati dei numeri di rete specifici della famiglia di protocolli. Questi dati identificano la rete per cui il chiamante cerca informazioni sulla route.

BestRoute [out]

Puntatore a una struttura specifica della famiglia di protocolli che riceve le informazioni di route migliori correnti, se presenti.

Valore restituito

Il valore restituito è uno dei codici seguenti.

Valore Descrizione
TRUE
Esiste almeno una route alla rete specificata. La route migliore viene restituita nella struttura a cui punta il parametro BestRoute .
FALSE
Non è presente alcuna route alla rete specificata o l'operazione non è riuscita. Chiamare GetLastError per ottenere altre informazioni:
NO_ERROR
L'operazione è riuscita, ma non è presente alcuna route alla rete specificata.
ERROR_INVALID_PARAMETER
Il valore del parametro ProtocolFamily non corrisponde ad alcuna famiglia di protocolli installata.
ERROR_NO_SYSTEM_RESOURCES
Non sono disponibili risorse sufficienti per eseguire l'operazione.

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

Getlasterror

IP_NETWORK

IPX_NETWORK

Identificatori della famiglia di protocolli RTMv1