Panoramica dell'helper IP

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 di IP Helper utilizza frequentemente i termini adapter e interfaccia. Un adattatore è un termine obsoleto che è una forma abbreviata di adattatore di rete, che originariamente faceva 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 la connessione di un nodo a un collegamento. Un'interfaccia è un'astrazione a livello di IP.

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

Nota

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

Funzioni di conversione dell'interfaccia

Funzione	Descrizione
ConvertInterfaceAliasToLuid	Converte un identificatore univoco locale (LUID) per un'interfaccia di rete al nome dell'interfaccia in Unicode.
ConvertInterfaceGuidToLuid	Converte un identificatore univoco globale (GUID) per un'interfaccia di rete nell'identificatore locale univoco (LUID) per l'interfaccia.
ConvertInterfaceIndexToLuid	Converte l'indice locale di 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 di un'interfaccia di rete nell'indice locale dell'interfaccia.
ConvertInterfaceLuidToNameA	Converte un LUID di un'interfaccia di rete nel nome dell'interfaccia ANSI.
ConvertInterfaceLuidToNameW	Converte un LUID per un'interfaccia di rete nel nome Unicode dell'interfaccia.
ConvertInterfaceNameToLuidA	Converte un nome di interfaccia di rete ANSI in un LUID per l'interfaccia.
ConvertInterfaceNameToLuidW	Converte il nome di un'interfaccia di rete Unicode nel LUID dell'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	Ottiene informazioni per l'interfaccia specificata nel computer locale.
GetIfStackTable	Restituisce una tabella delle voci di riga dello stack di interfacce di rete che specificano la relazione tra le 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 al livello di informazioni sull'interfaccia da ottenere.
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 un'entrata della struttura MIB_IPINTERFACE_ROW con valori predefiniti.
SetIpInterfaceEntry	Imposta le proprietà di un'interfaccia IP nel computer locale.

Funzioni di gestione degli indirizzi IP

Funzione	Descrizione
CreaVoceIndirizzoIpAnycast	Aggiunge una nuova voce di indirizzo IP anycast nel computer locale.
CreaCoppieDiIndirizziOrdinati	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 un indirizzo IP anycast dal 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 un'entrata di indirizzo IP multicast esistente nel computer locale.
GetMulticastIpAddressTable	Recupera la tabella degli indirizzi IP multicast nel computer locale.
GetUnicastIpAddressEntry	Recupera informazioni per un indirizzo IP unicast esistente nel computer locale.
GetUnicastIpAddressTable	Recupera la tabella degli indirizzi IP unicast nel computer locale.
InitializeUnicastIpAddressEntry	Inizializza una struttura di MIB_UNICASTIPADDRESS_ROW con valori predefiniti per una voce di indirizzo IP unicast nel computer locale.
NotifyStableUnicastIpAddressTable	Recupera la tabella stabile degli indirizzi IP unicast su un computer locale.
SetUnicastIpAddressEntry	Imposta le proprietà di una voce di indirizzo IP unicast esistente nel computer locale.

Funzioni di gestione degli indirizzi IP adiacenti

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

Funzioni di gestione del percorso IP

Funzione	Descrizione
FlushIpPathTable	Elimina la tabella del percorso IP nel computer locale.
GetIpPathEntry	Recupera informazioni per un entry del percorso IP nel computer locale.
GetIpPathTable	Recupera informazioni per una tabella del 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 instradamento IP dal computer locale.
GetBestRoute2	Recupera la voce della tabella di routing IP nel computer locale per il percorso migliore verso l'indirizzo IP di destinazione specificato.
GetIpForwardEntry2	Recupera informazioni per una voce di percorso 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 instradamento 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	Deregistra il driver per le notifiche di modifiche all'interfaccia IP, variazioni dell'indirizzo IP, cambiamenti della route IP e le 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.
NotificaModificaIndirizzoIpUnicast	Si registra per ricevere notifiche delle modifiche a tutte le interfacce IP unicast, agli indirizzi IPv4 unicast o agli indirizzi IPv6 unicast su un computer locale.

Le funzioni di gestione del client Teredo IPv6

Funzione	Descrizione
GetTeredoPort	Recupera il numero di porta UDP dinamico utilizzato dal client Teredo nel computer locale.
NotifyTeredoPortChange	Registra per ricevere notifiche sulle modifiche al numero di porta UDP utilizzato dal client Teredo per la porta del servizio Teredo su un computer locale.
NotifyStableUnicastIpAddressTable	Recupera la tabella stabile degli indirizzi IP unicast su 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	Consiste in 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 righe invertite dello stack delle interfacce di rete. 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 routing 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 inserimenti di indirizzi IP vicini.
MIB_IPPATH_ROW	Conserva le informazioni su un'entry del 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 delle voci relative agli 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 che viene passato a una funzione di callback nel momento in cui 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 di rilevamento degli indirizzi duplicati.
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.
COMPORTAMENTO_SCOPERTA_ROUTER	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.