Funzione GetUnicastIpAddressEntry

La funzione GetUnicastIpAddressEntry recupera informazioni per una voce di indirizzo IP unicast esistente in un computer locale.

Sintassi

NETIOAPI_API GetUnicastIpAddressEntry(
  _Inout_ PMIB_UNICASTIPADDRESS_ROW Row
);

Parametri

• Riga [in, out]
  Puntatore a una voce di struttura MIB_UNICASTIPADDRESS_ROW per una voce di indirizzo IP unicast. Al termine della restituzione, questa struttura viene aggiornata con le proprietà per un indirizzo IP unicast esistente.

Valore restituito

GetUnicastIpAddressEntry restituisce STATUS_SUCCESS se la funzione ha esito positivo.

Se la funzione ha esito negativo, GetUnicastIpAddressEntry restituisce uno dei codici di errore seguenti:

Codice restituito	Descrizione
STATUS_INVALID_PARAMETER	Un parametro non valido è stato passato alla funzione. Questo errore viene restituito se un puntatore NULL viene passato nel parametro Row, il membro Address della struttura MIB_UNICASTIPADDRESS_ROW che il parametro Row punta a non è stato impostato su un indirizzo IPv4 o IPv6 valido oppure sia i membri InterfaceLuid che InterfaceIndexdella strutturaMIB_UNICASTIPADDRESS_ROW non sono stati specificati.
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 InterfaceIndexdella struttura MIB_UNICASTIPADDRESS_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 nel membro Indirizzo della struttura MIB_UNICASTIPADDRESS_ROW a cui punta il parametro Row o se non si trova alcun stack IPv6 nel computer locale e un indirizzo IPv6 è stato specificato nel membro Address .
Altri	Utilizzare la funzione FormatMessage per ottenere la stringa di messaggio per l'errore restituito.

Commenti

La funzione GetUnicastIpAddressEntry viene in genere usata per recuperare una voce di struttura MIB_UNICASTIPADDRESS_ROW esistente da modificare. Un driver può quindi modificare i membri nella voce MIB_UNICASTIPADDRESS_ROW che vuole modificare e quindi chiamare la funzione SetUnicastIpAddressEntry .

In input, il driver deve inizializzare i membri seguenti della struttura MIB_UNICASTIPADDRESS_ROW a cui punta il parametro Row .

• Indirizzo
  Impostare su un indirizzo EPv4 o un indirizzo IPv6 valido.

• InterfaceLuid o InterfaceIndex
  Questi membri vengono usati nell'ordine elencato in precedenza. Quindi, se InterfaceLuid viene specificato, 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.

Nell'output, quando la chiamata ha esito positivo, GetUnicastIpAddressEntry recupera le altre proprietà per l'indirizzo IP unicast e inserisce la struttura MIB_UNICASTIPADDRESS_ROW a cui punta il parametro Row .

Il driver può chiamare la funzione GetUnicastIpAddressTable per enumerare le voci di indirizzo IP unicast 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

Vedi anche

CreateUnicastIpAddressEntry

DeleteUnicastIpAddressEntry

GetUnicastIpAddressTable

InitializeUnicastIpAddressEntry

MIB_UNICASTIPADDRESS_ROW

MIB_UNICASTIPADDRESS_TABLE

NotifyUnicastIpAddressChange

SetUnicastIpAddressEntry