Funzione GetIpNetTable (iphlpapi.h)

Articolo
02/28/2024

La funzione GetIpNetTable recupera la tabella di mapping degli indirizzi fisici IPv4.

Sintassi

IPHLPAPI_DLL_LINKAGE ULONG GetIpNetTable(
  [out]     PMIB_IPNETTABLE IpNetTable,
  [in, out] PULONG          SizePointer,
  [in]      BOOL            Order
);

Parametri

[out] IpNetTable

Puntatore a un buffer che riceve la tabella di mapping degli indirizzi fisici IPv4 come struttura MIB_IPNETTABLE .

[in, out] SizePointer

In input, specifica le dimensioni in byte del buffer a cui punta il parametro pIpNetTable .

Nell'output, se il buffer non è sufficientemente grande da contenere la tabella di mapping restituita, la funzione imposta questo parametro uguale alle dimensioni del buffer necessarie in byte.

[in] Order

Valore booleano che specifica se la tabella di mapping restituita deve essere ordinata in ordine crescente in base all'indirizzo IP. Se questo parametro è TRUE, la tabella viene ordinata.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR o ERROR_NO_DATA.

Se la funzione ha esito negativo o non restituisce dati, il valore restituito è uno dei codici di errore seguenti.

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Il buffer a cui punta il parametro pIpNetTable non è sufficiente. La dimensione richiesta viene restituita nella variabile DWORD a cui punta il parametro pdwSize .
ERROR_INVALID_PARAMETER	Alla funzione è stato passato un parametro non valido. Questo errore viene restituito se il parametro pdwSize è NULL o GetIpNetTable non è in grado di scrivere nella memoria a cui punta il parametro pdwSize .
ERROR_NO_DATA	Non sono presenti dati da restituire. La tabella di mapping degli indirizzi fisici da IPv4 a quella fisica è vuota. Questo valore restituito indica che la chiamata alla funzione GetIpNetTable ha avuto esito positivo, ma non sono stati restituiti dati.
ERROR_NOT_SUPPORTED	Il trasporto IPv4 non è configurato nel computer locale.
Altri	Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

The
La funzione GetIpNetTable enumera le voci ARP (Address Resolution Protocol) per IPv4 in un sistema locale dalla tabella IPv4 al mapping degli indirizzi fisici e restituisce queste informazioni in una struttura MIB_IPNETTABLE .

Le voci degli indirizzi IPv4 vengono restituite in una struttura MIB_IPNETTABLE nel buffer a cui punta il parametro pIpNetTable . La struttura MIB_IPNETTABLE contiene un conteggio delle voci ARP e una matrice di strutture MIB_IPNETROW per ogni voce di indirizzo IPv4.

Si noti che la struttura restituita MIB_IPNETTABLE a cui punta il parametro pIpNetTable può contenere spaziatura interna per l'allineamento tra il membro dwNumEntries e la prima voce di matrice MIB_IPNETROW nel membro della tabella della struttura MIB_IPNETTABLE . La spaziatura interna per l'allineamento può essere presente anche tra le voci della matrice MIB_IPNETROW . Qualsiasi accesso a una voce di matrice MIB_IPNETROW deve presupporre che la spaziatura interna possa esistere.

in Windows Vista e versioni successive, la funzione GetIpNetTable2 può essere usata per recuperare gli indirizzi IP adiacenti per IPv6 e IPv4.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	iphlpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll