Funzione GetIpNetEntry2 (netioapi.h)

Articolo
02/29/2024

La funzione GetIpNetEntry2 recupera informazioni per una voce di indirizzo IP adiacente nel computer locale.

Sintassi

IPHLPAPI_DLL_LINKAGE _NETIOAPI_SUCCESS_ NETIOAPI_API GetIpNetEntry2(
  [in, out] PMIB_IPNET_ROW2 Row
);

Parametri

[in, out] Row

Puntatore a una voce di struttura MIB_IPNET_ROW2 per una voce di indirizzo IP adiacente. Al termine della restituzione, questa struttura verrà aggiornata con le proprietà per l'indirizzo IP adiacente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene 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 di interfaccia specificato dal membro InterfaceLuid o InterfaceIndex del MIB_IPNET_ROW2 a cui punta il parametro Row non è un valore nel computer locale.
ERROR_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 Address del MIB_IPNET_ROW2 a cui punta il parametro Row non è stato impostato su un indirizzo IPv4 o IPv6 valido oppure entrambi i membri InterfaceLuid o InterfaceIndex del MIB_IPNET_ROW2 a cui punta il parametro Row non sono stati specificati.
ERROR_NOT_FOUND	Element not found. Questo errore viene restituito se l'interfaccia di rete specificata dal membro InterfaceLuid o InterfaceIndex della struttura MIB_IPNET_ROW2 a cui punta il parametro Row non corrisponde all'indirizzo IP adiacente e alla famiglia di indirizzi specificata nel membro Address nella struttura MIB_IPNET_ROW2 .
ERROR_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 nel membro Address della struttura MIB_IPNET_ROW2 a cui punta il parametro Row . Questo errore viene restituito anche se non si trova alcun stack IPv6 nel computer locale e un indirizzo IPv6 è stato specificato nel membro Address della struttura MIB_IPNET_ROW2 .
Altri	Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

La funzione GetIpNetEntry2 viene definita in Windows Vista e versioni successive.

La funzione GetIpNetEntry2 viene usata per recuperare una voce di struttura MIB_IPNET_ROW2 .

All'input, il membro Address nella struttura MIB_IPNET_ROW2 a cui punta il parametro Row deve essere inizializzato in un indirizzo e una famiglia IPv6 adiacenti validi. Inoltre, almeno uno dei membri seguenti nella struttura MIB_IPNET_ROW2 a cui punta il parametro Row deve essere inizializzato: InterfaceLuid o InterfaceIndex.

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

Quando la chiamata ha esito positivo, GetIpNetEntry2 recupera le altre proprietà per l'indirizzo IP adiacente e compila la struttura MIB_IPNET_ROW2 a cui punta il parametro Row .

È possibile chiamare la funzione GetIpNetTable2 per enumerare le voci di indirizzo IP adiacente 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 (include Iphlpapi.h)
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll