Funzione GetIpPathEntry
La funzione GetIpPathEntry recupera informazioni per una voce di percorso IP in un computer locale.
Sintassi
NETIOAPI_API GetIpPathEntry(
_Inout_ PMIB_IPPATH_ROW Row
);
Parametri
- Riga [in, out]
Puntatore a una voce di struttura MIB_IPPATH_ROW per una voce di percorso IP. In caso di esito positivo, questa struttura viene aggiornata con le proprietà per la voce del percorso IP.
Valore restituito
GetIpPathEntry restituisce STATUS_SUCCESS se la funzione ha esito positivo.
Se la funzione ha esito negativo, GetIpPathEntry restituisce uno dei codici di errore seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER | Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se un puntatore NULL viene passato nel parametro Row , il membro si_family nel membro Destination della struttura MIB_IPPATH_ROW a cui il parametro Row punta non è stato impostato su AF_INET o AF_INET6 oppure i membri InterfaceLuid e InterfaceIndex della struttura MIB_IPPATH_ROW non sono stati specificati. Questo errore viene restituito anche se il membro si_family nel membro Source della struttura MIB_IPPATH_ROW non corrisponde alla famiglia di indirizzi IP di destinazione e il si_family per l'indirizzo IP di origine non è stato specificato come AF_UNSPEC. |
| STATUS_NOT_FOUND | Impossibile trovare l'interfaccia specificata. Questo errore viene restituito se la funzione non riesce a trovare l'interfaccia di rete specificata dal membro InterfaceLuid o InterfaceIndex della struttura MIB_IPPATH_ROW a cui punta il parametro Row . |
| STATUS_NOT_SUPPORTED | La richiesta non è supportata. Questo errore viene restituito se non si trova alcun stack IPv4 nel computer locale e un indirizzo IPv4 è stato specificato nei membri Source e Destination della struttura MIB_IPPATH_ROW a cui punta il parametro Row oppure se non si trova alcun stack IPv6 nel computer locale e nei membri source eDestination è stato specificato un indirizzo IPv6. |
| Altri | Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito. |
Commenti
La funzione GetIpPathEntry viene utilizzata per recuperare una voce della struttura MIB_IPPATH_ROW .
In input, il driver deve inizializzare i membri seguenti della struttura MIB_IPPATH_ROW a cui punta il parametro Row .
Destinazione
Impostare su un indirizzo e una famiglia IPv4 o IPv6 validi.Origine
Impostare la famiglia di indirizzi specificata nel membro Source sulla famiglia di indirizzi IP di destinazione specificata nel membro Destinazione o su AF_UNSPEC.InterfaceLuid o InterfaceIndex
Questi membri vengono usati nell'ordine elencato in precedenza. Se quindi si specifica InterfaceLuid , questo membro viene usato per determinare l'interfaccia. Se non è stato impostato alcun valore per il membro InterfaceLuid (il valore di questo membro è stato impostato su zero), il membro InterfaceIndex viene usato successivamente per determinare l'interfaccia.
In caso di esito positivo della chiamata, GetIpPathEntry recupera le altre proprietà per la voce del percorso IP e compila la struttura MIB_IPPATH_ROW a cui punta il parametro Row .
Il driver può chiamare la funzione GetIpPathTable per enumerare le voci del percorso IP in un computer locale.
Requisiti
Piattaforma di destinazione |
Universale |
Versione |
Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows. |
Intestazione |
Netioapi.h (include Netioapi.h) |
Libreria |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |