Panoramica dell'helper IP

Articolo
06/15/2023

L'helper IP (Internet Protocol Helper) consente ai driver di recuperare informazioni sulla configurazione di rete del computer locale e di modificare tale configurazione. L'helper IP fornisce anche meccanismi di notifica per assicurarsi che un driver venga informato quando determinati aspetti della configurazione della rete del computer locale cambiano. L'helper IP è disponibile in Windows Vista e versioni successive dei sistemi operativi Microsoft Windows.

Molte delle funzioni helper IP passano parametri di struttura che rappresentano i tipi di dati associati alla tecnologia MIB (Management Information Base). Le funzioni helper IP usano queste strutture MIB per rappresentare varie informazioni di rete.

La documentazione dell'helper IP usa ampiamente i termini "adapter" e "interface". Una scheda è un termine legacy che è una forma abbreviata di scheda di rete, che originariamente fa riferimento a una forma di hardware di rete. Un adattatore è un'astrazione a livello di collegamento dati.

Un'interfaccia è descritta nei documenti RFC IETF come concetto astratto che rappresenta l'allegato di un nodo a un collegamento. Un'interfaccia è un'astrazione a livello DI IP.

Il driver può usare le funzioni in modalità kernel, le strutture MIB e le enumerazioni MIB e NL (Network Layer) seguenti per recuperare e modificare le impostazioni di configurazione per il trasporto TCP/IP (Transmission Control Protocol/IP) in un computer locale.

Nota

Quando si sviluppa codice driver, seguire le istruzioni per includere i file di intestazione.

Funzioni di conversione dell'interfaccia

Funzione	Descrizione
ConvertInterfaceAliasToLuid	Converte un identificatore univoco locale (LUID) per un'interfaccia di rete nel nome dell'interfaccia Unicode.
ConvertInterfaceGuidToLuid	Converte un identificatore univoco globale (GUID) per un'interfaccia di rete nel LUID per l'interfaccia.
ConvertInterfaceIndexToLuid	Converte un indice locale per un'interfaccia di rete nel LUID per l'interfaccia .
ConvertInterfaceLuidToAlias	Converte un LUID per un'interfaccia di rete in un alias di interfaccia.
ConvertInterfaceLuidToGuid	Converte un LUID per un'interfaccia di rete in un GUID per l'interfaccia.
ConvertInterfaceLuidToIndex	Converte un LUID per un'interfaccia di rete nell'indice locale per l'interfaccia.
ConvertInterfaceLuidToNameA	Converte un LUID per un'interfaccia di rete nel nome dell'interfaccia ANSI.
ConvertInterfaceLuidToNameW	Converte un LUID per un'interfaccia di rete nel nome dell'interfaccia Unicode.
ConvertInterfaceNameToLuidA	Converte un nome di interfaccia di rete ANSI nel LUID per l'interfaccia.
ConvertInterfaceNameToLuidW	Converte un nome di interfaccia di rete Unicode nel LUID per l'interfaccia.
if_indextoname	Converte l'indice locale per un'interfaccia di rete nel nome dell'interfaccia ANSI.
if_nametoindex	Converte il nome dell'interfaccia ANSI per un'interfaccia di rete nell'indice locale per l'interfaccia.

Funzioni di gestione dell'interfaccia

Funzione	Descrizione
GetIfEntry2	Recupera informazioni per l'interfaccia specificata nel computer locale.
GetIfStackTable	Recupera una tabella di voci di riga dello stack di interfacce di rete che specificano la relazione delle interfacce di rete in uno stack di interfacce.
GetIfTable2	Recupera la tabella dell'interfaccia MIB-II.
GetIfTable2Ex	Recupera la tabella dell'interfaccia MIB-II, in base a un livello di informazioni sull'interfaccia da recuperare.
GetInvertedIfStackTable	Recupera una tabella di voci di riga dello stack di interfacce di rete invertite che specificano la relazione delle interfacce di rete in uno stack di interfacce.
GetIpInterfaceEntry	Recupera le informazioni IP per l'interfaccia specificata nel computer locale.
GetIpInterfaceTable	Recupera le voci dell'interfaccia IP nel computer locale.
InitializeIpInterfaceEntry	Inizializza i membri di una voce di struttura MIB_IPINTERFACE_ROW con valori predefiniti.
SetIpInterfaceEntry	Imposta le proprietà di un'interfaccia IP nel computer locale.

Funzioni Gestione indirizzi IP

Funzione	Descrizione
CreateAnycastIpAddressEntry	Aggiunge una nuova voce di indirizzo IP anycast nel computer locale.
CreateSortedAddressPairs	Associa un elenco fornito di indirizzi di destinazione insieme agli indirizzi IP locali del computer host e ordina le coppie in base all'ordine di comunicazione preferito.
CreateUnicastIpAddressEntry	Aggiunge una nuova voce di indirizzo IP unicast nel computer locale.
DeleteAnycastIpAddressEntry	Elimina una voce di indirizzo IP anycast esistente nel computer locale.
DeleteUnicastIpAddressEntry	Elimina una voce di indirizzo IP unicast esistente dal computer locale.
GetAnycastIpAddressEntry	Recupera informazioni per una voce di indirizzo IP anycast esistente nel computer locale.
GetAnycastIpAddressTable	Recupera la tabella degli indirizzi IP anycast nel computer locale.
GetMulticastIpAddressEntry	Recupera informazioni per una voce di indirizzo IP multicast esistente nel computer locale.
GetMulticastIpAddressTable	Recupera la tabella degli indirizzi IP multicast nel computer locale.
GetUnicastIpAddressEntry	Recupera informazioni per una voce di indirizzo IP unicast esistente nel computer locale.
GetUnicastIpAddressTable	Recupera la tabella degli indirizzi IP unicast nel computer locale.
InitializeUnicastIpAddressEntry	Inizializza una struttura MIB_UNICASTIPADDRESS_ROW con valori predefiniti per una voce di indirizzo IP unicast nel computer locale.
NotifyStableUnicastIpAddressTable	Recupera la tabella degli indirizzi IP unicast stabile in un computer locale.
SetUnicastIpAddressEntry	Imposta le proprietà di una voce di indirizzo IP unicast esistente nel computer locale.

Funzioni di gestione degli indirizzi IP neighbor

Funzione	Descrizione
CreateIpNetEntry2	Crea una nuova voce di indirizzo IP adiacente nel computer locale.
DeleteIpNetEntry2	Elimina una voce di indirizzo IP adiacente dal computer locale.
FlushIpNetTable2	Scarica la tabella adiacente IP nel computer locale.
GetIpNetEntry2	Recupera informazioni per una voce di indirizzo IP adiacente nel computer locale.
GetIpNetTable2	Recupera la tabella adiacente IP nel computer locale.
ResolveIpNetEntry2	Risolve l'indirizzo fisico per una voce di indirizzo IP adiacente nel computer locale.
SetIpNetEntry2	Imposta l'indirizzo fisico di una voce di indirizzo IP adiacente esistente nel computer locale.

Funzioni di gestione dei percorsi IP

Funzione	Descrizione
FlushIpPathTable	Scarica la tabella del percorso IP nel computer locale.
GetIpPathEntry	Recupera informazioni per una voce di percorso IP nel computer locale.
GetIpPathTable	Recupera informazioni per una voce di percorso IP nel computer locale.

Funzioni di gestione delle route IP

Funzione	Descrizione
CreateIpForwardEntry2	Crea una nuova voce di route IP nel computer locale.
DeleteIpForwardEntry2	Elimina una voce di route IP dal computer locale.
GetBestRoute2	Recupera la voce di route IP nel computer locale per la route migliore all'indirizzo IP di destinazione specificato.
GetIpForwardEntry2	Recupera informazioni per una voce di route IP nel computer locale.
GetIpForwardTable2	Recupera le voci di route IP nel computer locale.
InitializeIpForwardEntry	Inizializza una struttura MIB_IPFORWARD_ROW2 con valori predefiniti per una voce di route IP nel computer locale.
SetIpForwardEntry2	Imposta le proprietà di una voce di route IP nel computer locale.

Funzioni di gestione della memoria della tabella IP

Funzione	Descrizione
FreeMibTable	Libera il buffer allocato dalle funzioni che restituiscono tabelle di interfacce di rete, indirizzi e route, ad esempio GetIfTable2 e GetAnycastIpAddressTable.

Funzioni di notifica

Funzione	Descrizione
CancelMibChangeNotify2	Annulla la registrazione del driver per le notifiche di modifica per le modifiche all'interfaccia IP, modifiche all'indirizzo IP, modifiche alla route IP e richieste per recuperare la tabella stabile degli indirizzi IP unicast.
NotifyIpInterfaceChange	Registra il driver per ricevere una notifica per le modifiche a tutte le interfacce IP, le interfacce IPv4 o le interfacce IPv6 in un computer locale.
NotifyRouteChange2	Registra per ricevere una notifica per le modifiche apportate alle voci di route IP in un computer locale.
NotifyUnicastIpAddressChange	Registra per ricevere una notifica per le modifiche a tutte le interfacce IP unicast, gli indirizzi IPv4 unicast o gli indirizzi IPv6 unicast in un computer locale.

Funzioni di gestione client Teredo IPv6

Funzione	Descrizione
GetTeredoPort	Recupera il numero di porta UDP dinamico utilizzato dal client Teredo nel computer locale.
NotifyTeredoPortChange	Registra per ricevere una notifica per le modifiche apportate al numero di porta UDP usato dal client Teredo per la porta del servizio Teredo in un computer locale.
NotifyStableUnicastIpAddressTable	Recupera la tabella degli indirizzi IP unicast stabile in un computer locale.

Strutture MIB

Struttura	Descrizione
IP_ADDRESS_PREFIX	Archivia un prefisso di indirizzo IP.
MIB_ANYCASTIPADDRESS_ROW	Archivia informazioni su un indirizzo IP anycast.
MIB_ANYCASTIPADDRESS_TABLE	Contiene una tabella di voci di indirizzo IP anycast.
MIB_IF_ROW2	Archivia informazioni su una particolare interfaccia.
MIB_IF_TABLE2	Contiene una tabella di voci di interfaccia logica e fisica.
MIB_IFSTACK_ROW	Rappresenta la relazione tra due interfacce di rete.
MIB_IFSTACK_TABLE	Contiene una tabella di voci di riga nello stack dell'interfaccia di rete. Questa tabella specifica la relazione delle interfacce di rete in uno stack di interfacce.
MIB_INVERTEDIFSTACK_ROW	Rappresenta la relazione tra due interfacce di rete.
MIB_INVERTEDIFSTACK_TABLE	Contiene una tabella di voci di riga dello stack di interfacce di rete invertite. Questa tabella specifica la relazione delle interfacce di rete in uno stack di interfacce in ordine inverso.
MIB_IPFORWARD_ROW2	Archivia informazioni su una voce di route IP.
MIB_IPFORWARD_TABLE2	Contiene una tabella di voci di route IP.
MIB_IPINTERFACE_ROW	Archivia le informazioni di gestione dell'interfaccia per una determinata famiglia di indirizzi IP in un'interfaccia di rete.
MIB_IPINTERFACE_TABLE	Contiene una tabella di voci dell'interfaccia IP.
MIB_IPNET_ROW2	Archivia informazioni su un indirizzo IP adiacente.
MIB_IPNET_TABLE2	Contiene una tabella di voci di indirizzi IP adiacenti.
MIB_IPPATH_ROW	Archivia informazioni su una voce di percorso IP.
MIB_IPPATH_TABLE	Contiene una tabella di voci di percorso IP.
MIB_MULTICASTIPADDRESS_ROW	Archivia informazioni su un indirizzo IP multicast.
MIB_MULTICASTIPADDRESS_TABLE	Contiene una tabella di voci di indirizzi IP multicast.
MIB_UNICASTIPADDRESS_ROW	Archivia informazioni su un indirizzo IP unicast.
MIB_UNICASTIPADDRESS_TABLE	Contiene una tabella di voci di indirizzi IP unicast.

Enumerazioni MIB

Enumerazione	Descrizione
MIB_IF_TABLE_LEVEL	Definisce il livello di informazioni sull'interfaccia da recuperare.
MIB_NOTIFICATION_TYPE	Definisce il tipo di notifica passato a una funzione di callback quando si verifica una notifica.

Enumerazioni NL

Enumerazione	Descrizione
NL_ADDRESS_TYPE	Specifica il tipo di indirizzo IP del livello di rete.
NL_DAD_STATE	Definisce lo stato daD (Duplicate Address Detection).
NL_LINK_LOCAL_ADDRESS_BEHAVIOR	Definisce il comportamento dell'indirizzo locale del collegamento.
NL_NEIGHBOR_STATE	Definisce lo stato di un indirizzo IP adiacente del livello di rete, come descritto in RFC 2461, sezione 7.3.2.
NL_PREFIX_ORIGIN	Definisce l'origine del prefisso o della parte di rete dell'indirizzo IP.
NL_ROUTE_ORIGIN	Definisce l'origine della route IP.
NL_ROUTE_PROTOCOL	Definisce il meccanismo di routing con cui è stata aggiunta una route IP, come descritto in RFC 4292.
NL_ROUTER_DISCOVERY_BEHAVIOR	Definisce il comportamento di individuazione del router, come descritto in RFC 2461.
NL_SUFFIX_ORIGIN	Definisce l'origine del suffisso o della parte host dell'indirizzo IP.

Condividi tramite