struttura IP_ADAPTER_UNICAST_ADDRESS_LH (iptypes.h)

Articolo
08/24/2023

La struttura IP_ADAPTER_UNICAST_ADDRESS archivia un singolo indirizzo IP unicast in un elenco collegato di indirizzi IP per una scheda specifica.

Sintassi

typedef struct _IP_ADAPTER_UNICAST_ADDRESS_LH {
  union {
    ULONGLONG Alignment;
    struct {
      ULONG Length;
      DWORD Flags;
    };
  };
  struct _IP_ADAPTER_UNICAST_ADDRESS_LH *Next;
  SOCKET_ADDRESS                        Address;
  IP_PREFIX_ORIGIN                      PrefixOrigin;
  IP_SUFFIX_ORIGIN                      SuffixOrigin;
  IP_DAD_STATE                          DadState;
  ULONG                                 ValidLifetime;
  ULONG                                 PreferredLifetime;
  ULONG                                 LeaseLifetime;
  UINT8                                 OnLinkPrefixLength;
} IP_ADAPTER_UNICAST_ADDRESS_LH, *PIP_ADAPTER_UNICAST_ADDRESS_LH;

Members

Alignment

Length

Tipo: ULONG

Lunghezza, in byte, di questa struttura.

Flags

Tipo: DWORD

Set di flag per questo indirizzo IP.

La tabella seguente mostra i valori possibili. Queste costanti sono definite nel file di intestazione Iptypes.h .

Valore	Significato
IP_ADAPTER_ADDRESS_DNS_ELIGIBLE	L'indirizzo IP è valido per essere visualizzato in DNS.
IP_ADAPTER_ADDRESS_TRANSIENT	L'indirizzo IP è un indirizzo cluster e non deve essere usato dalla maggior parte delle applicazioni.

Next

Tipo: struct _IP_ADAPTER_UNICAST_ADDRESS*

Puntatore alla struttura di indirizzi dell'adattatore IP successiva nell'elenco.

Address

Tipo: SOCKET_ADDRESS

Indirizzo IP per questa voce di indirizzo IP unicast. Questo membro può essere un indirizzo IPv6 o un indirizzo IPv4.

PrefixOrigin

Tipo: IP_PREFIX_ORIGIN

Prefisso o parte di rete dell'indirizzo IP. Questo membro può essere uno dei valori del tipo di enumerazione IP_PREFIX_ORIGIN definito nel file di intestazione Iptypes.h .

SuffixOrigin

Tipo: IP_SUFFIX_ORIGIN

Suffisso o parte host dell'indirizzo IP. Questo membro può essere uno dei valori del tipo di enumerazione IP_SUFFIX_ORIGIN definito nel file di intestazione Iptypes.h .

DadState

Tipo: IP_DAD_STATE

Stato di rilevamento dell'indirizzo duplicato (DAD). Questo membro può essere uno dei valori del tipo di enumerazione IP_DAD_STATE definito nel file di intestazione Iptypes.h . Il rilevamento degli indirizzi duplicati è disponibile sia per gli indirizzi IPv4 che IPv6.

ValidLifetime

Tipo: ULONG

Durata massima, in secondi, valida per l'indirizzo IP. Un valore di 0xffffffff viene considerato infinito.

PreferredLifetime

Tipo: ULONG

Durata preferita, in secondi, che l'indirizzo IP è valido. Un valore di 0xffffffff viene considerato infinito.

LeaseLifetime

Tipo: ULONG

Durata del lease, in secondi, valida per l'indirizzo IP.

OnLinkPrefixLength

Tipo: UINT8

Lunghezza, in bit, del prefisso o della parte di rete dell'indirizzo IP. Per un indirizzo IPv4 unicast, qualsiasi valore maggiore di 32 è un valore non valido. Per un indirizzo IPv6 unicast, qualsiasi valore maggiore di 128 è un valore non valido. Il valore 255 viene comunemente usato per rappresentare un valore non valido.

Nota Questo membro della struttura è disponibile solo in Windows Vista e versioni successive.

Commenti

La struttura IP_ADAPTER_ADDRESSES viene recuperata dalla funzione GetAdaptersAddresses . Il membro FirstUnicastAddress della struttura IP_ADAPTER_ADDRESSES è un puntatore a un elenco collegato di strutture IP_ADAPTER_UNICAST_ADDRESS .

Le dimensioni della struttura IP_ADAPTER_UNICAST_ADDRESS sono state modificate in Windows Vista e versioni successive. Il membro Length deve essere utilizzato per determinare quale versione della struttura IP_ADAPTER_UNICAST_ADDRESS viene utilizzata.

La versione della struttura IP_ADAPTER_UNICAST_ADDRESS in Windows Vista e versioni successive include il nuovo membro seguente: OnLinkPrefixLength.

Quando questa struttura viene usata con la funzione GetAdaptersAddresses e funzioni di gestione simili, vengono visualizzati tutti gli indirizzi configurati, inclusi gli indirizzi duplicati. Tali voci di indirizzi duplicati possono verificarsi quando gli indirizzi vengono configurati in modo statico. Tali report facilitano la risoluzione dei problemi dell'amministratore. Il membro DadState è efficace per identificare e risolvere tali situazioni.

In Windows SDK la versione della struttura da usare in Windows Vista e versioni successive viene definita come IP_ADAPTER_UNICAST_ADDRESS_LH. In Windows SDK la versione di questa struttura da usare nei sistemi precedenti, tra cui Windows XP con Service Pack 1 (SP1) e versioni successive viene definita come IP_ADAPTER_UNICAST_ADDRESS_XP. Quando si compila un'applicazione se la piattaforma di destinazione è Windows Vista e versioni successive (NTDDI_VERSION >= NTDDI_VISTA, _WIN32_WINNT >= 0x0600o WINVER >= 0x0600), la struttura IP_ADAPTER_UNICAST_ADDRESS_LH viene tipizzata nella struttura IP_ADAPTER_UNICAST_ADDRESS . Quando si compila un'applicazione se la piattaforma di destinazione non è Windows Vista e versioni successive, la struttura IP_ADAPTER_UNICAST_ADDRESS_XP viene tipizzata nella struttura IP_ADAPTER_UNICAST_ADDRESS .

La struttura SOCKET_ADDRESS viene utilizzata nella struttura IP_ADAPTER_UNICAST_ADDRESS . In Microsoft Windows Software Development Kit (SDK) rilasciato per Windows Vista e versioni successive, l'organizzazione dei file di intestazione è stata modificata e la struttura SOCKET_ADDRESS è definita nel file di intestazione Ws2def.h che viene automaticamente incluso dal file di intestazione Winsock2.h . Nella piattaforma Software Development Kit (SDK) rilasciata per Windows Server 2003 e Windows XP, la struttura SOCKET_ADDRESS viene dichiarata nel file di intestazione Winsock2.h . Per usare la struttura IP_ADAPTER_UNICAST_ADDRESS , è necessario includere il file di intestazione Winsock2.h prima del file di intestazione Iphlpapi.h .

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	iptypes.h (include Iphlpapi.h)