Funzione GetIpPathEntry (netioapi.h)

Articolo
03/15/2023

La funzione GetIpPathEntry recupera informazioni per una voce del percorso IP nel computer locale.

Sintassi

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIpPathEntry(
  [in, out] PMIB_IPPATH_ROW Row
);

Parametri

[in, out] Row

Puntatore a una voce di struttura MIB_IPPATH_ROW per una voce del percorso IP. Al termine della restituzione, questa struttura verrà aggiornata con le proprietà per la voce del percorso IP.

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.

Codice restituito	Descrizione
ERROR_FILE_NOT_FOUND	Non è possibile trovare il file specificato. Questo errore viene restituito se l'interfaccia di rete LUID o l'indice dell'interfaccia specificato dal membro InterfaceLuid o InterfaceIndex del MIB_IPPATH_ROW puntato dal parametro Row non è un valore nel computer locale.
ERROR_INVALID_PARAMETER	Un parametro non è corretto. Questo errore viene restituito se un puntatore NULL viene passato al parametro Row, il membro si_family membro del membro Destination del MIB_IPPATH_ROW puntato dal parametro Row non è impostato su AF_INET o AF_INET6 o entrambi i membri InterfaceLuid o InterfaceIndex del MIB_IPPATH_ROW puntato dal parametro Row non sono specificati. Questo errore viene restituito anche se il membro si_family nel membro Origine del MIB_IPPATH_ROW puntato dal parametro Row non corrisponde alla famiglia di indirizzi IP di destinazione e il si_family per l'indirizzo IP di origine non viene specificato comeAF_UNSPEC.
ERROR_NOT_FOUND	Element not found. Questo errore viene restituito se l'interfaccia di rete specificata dal membro InterfaceLuid o InterfaceIndex della struttura MIB_IPPATH_ROW puntata dal parametro Row non corrisponde all'indirizzo IP e alla famiglia di indirizzi specificata nel membro Destination nella struttura MIB_IPPATH_ROW .
ERROR_NOT_SUPPORTED	La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv4 nel computer locale e viene specificato un indirizzo IPv4 nei membri origine e destinazione del MIB_IPPATH_ROW puntato dal parametro Row . Questo errore viene restituito anche se non è presente alcun stack IPv6 nel computer locale e viene specificato un indirizzo IPv6 nei membri di origine e destinazione .
Altri	Usare FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

La funzione GetIpPathEntry è definita in Windows Vista e versioni successive.

La funzione GetIpPathEntry viene usata per recuperare una voce di struttura MIB_IPPATH_ROW .

In input, il membro Destination nella struttura MIB_IPPATH_ROW puntato dal parametro Row deve essere inizializzato in un indirizzo IPv4 o IPv6 valido e una famiglia. La famiglia di indirizzi specificata nel membro di origine nella struttura MIB_IPPATH_ROW deve corrispondere anche alla famiglia di indirizzi IP di destinazione specificata nel membro destinazione o alla famiglia di indirizzi nel membro di origine deve essere specificata come AF_UNSPEC. Inoltre, almeno uno dei membri seguenti nella struttura MIB_IPPATH_ROW punta al parametro Row deve essere inizializzato: InterfaceLuid o InterfaceIndex.

I campi vengono usati nell'ordine elencato sopra. Quindi, se si specifica InterfaceLuid , questo membro viene usato per determinare l'interfaccia. Se non viene impostato alcun valore per il membro InterfaceLuid (i valori di questo membro sono impostati su zero), il membro InterfaceIndex viene usato successivamente per determinare l'interfaccia.

Nell'output quando la chiamata ha esito positivo, GetIpPathEntry recupera le altre proprietà per la voce del percorso IP e compila la struttura MIB_IPPATH_ROW puntata dal parametro Row .

La funzione GetIpPathTable può essere chiamata per enumerare le voci del percorso IP in un computer locale.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	netioapi.h (includere Iphlpapi.h)
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll

Vedi anche

Condividi tramite