estrutura IP_ADAPTER_UNICAST_ADDRESS_LH (iptypes.h)

Artigo
03/11/2023

A estrutura IP_ADAPTER_UNICAST_ADDRESS armazena um único endereço IP unicast em uma lista vinculada de endereços IP para um adaptador específico.

Sintaxe

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;

Membros

Alignment

Length

Tipo: ULONG

O comprimento, em bytes, dessa estrutura.

Flags

Tipo: DWORD

Um conjunto de sinalizadores para esse endereço IP.

A tabela a seguir mostra os possíveis valores. Essas constantes são definidas no arquivo de cabeçalho Iptypes.h .

Valor	Significado
IP_ADAPTER_ADDRESS_DNS_ELIGIBLE	O endereço IP é legal para aparecer no DNS.
IP_ADAPTER_ADDRESS_TRANSIENT	O endereço IP é um endereço de cluster e não deve ser usado pela maioria dos aplicativos.

Next

Tipo: struct _IP_ADAPTER_UNICAST_ADDRESS*

Um ponteiro para a próxima estrutura de endereços do adaptador IP na lista.

Address

Tipo: SOCKET_ADDRESS

O endereço IP dessa entrada de endereço IP unicast. Esse membro pode ser um endereço IPv6 ou um endereço IPv4.

PrefixOrigin

Tipo: IP_PREFIX_ORIGIN

O prefixo ou a parte de rede do IP do endereço. Esse membro pode ser um dos valores do tipo de enumeração IP_PREFIX_ORIGIN definido no arquivo de cabeçalho Iptypes.h .

SuffixOrigin

Tipo: IP_SUFFIX_ORIGIN

O sufixo ou parte do host do endereço IP. Esse membro pode ser um dos valores do tipo de enumeração IP_SUFFIX_ORIGIN definido no arquivo de cabeçalho Iptypes.h .

DadState

Tipo: IP_DAD_STATE

O estado de detecção de endereço duplicado (DAD). Esse membro pode ser um dos valores do tipo de enumeração IP_DAD_STATE definido no arquivo de cabeçalho Iptypes.h . A detecção de endereços duplicados está disponível para endereços IPv4 e IPv6.

ValidLifetime

Tipo: ULONG

O tempo de vida máximo, em segundos, em que o endereço IP é válido. Um valor de 0xffffffff é considerado infinito.

PreferredLifetime

Tipo: ULONG

O tempo de vida preferencial, em segundos, em que o endereço IP é válido. Um valor de 0xffffffff é considerado infinito.

LeaseLifetime

Tipo: ULONG

O tempo de vida de concessão, em segundos, em que o endereço IP é válido.

OnLinkPrefixLength

Tipo: UINT8

O comprimento, em bits, do prefixo ou da parte de rede do endereço IP. Para um endereço IPv4 unicast, qualquer valor maior que 32 é um valor inválido. Para um endereço IPv6 unicast, qualquer valor maior que 128 é um valor inválido. Um valor de 255 é comumente usado para representar um valor ilegal.

Nota Esse membro da estrutura só está disponível no Windows Vista e posterior.

Comentários

A estrutura IP_ADAPTER_ADDRESSES é recuperada pela função GetAdaptersAddresses . O membro FirstUnicastAddress da estrutura IP_ADAPTER_ADDRESSES é um ponteiro para uma lista vinculada de estruturas de IP_ADAPTER_UNICAST_ADDRESS .

O tamanho da estrutura de IP_ADAPTER_UNICAST_ADDRESS foi alterado no Windows Vista e posterior. O membro Length deve ser usado para determinar qual versão da estrutura IP_ADAPTER_UNICAST_ADDRESS está sendo usada.

A versão da estrutura IP_ADAPTER_UNICAST_ADDRESS no Windows Vista e posteriores tem o novo membro a seguir adicionado: OnLinkPrefixLength.

Quando essa estrutura é usada com a função GetAdaptersAddresses e funções de gerenciamento semelhantes, todos os endereços configurados são mostrados, incluindo endereços duplicados. Essas entradas de endereço duplicadas podem ocorrer quando os endereços são configurados estaticamente. Esse relatório facilita a solução de problemas do administrador. O membro DadState é eficaz na identificação e solução de problemas dessas situações.

No SDK do Windows, a versão da estrutura para uso no Windows Vista e posterior é definida como IP_ADAPTER_UNICAST_ADDRESS_LH. No SDK do Windows, a versão dessa estrutura a ser usada em sistemas anteriores, incluindo o Windows XP com Service Pack 1 (SP1) e posterior, é definida como IP_ADAPTER_UNICAST_ADDRESS_XP. Ao compilar um aplicativo se a plataforma de destino for Windows Vista e posterior (NTDDI_VERSION >= NTDDI_VISTA, _WIN32_WINNT >= 0x0600ou WINVER >= 0x0600), a estrutura IP_ADAPTER_UNICAST_ADDRESS_LH será digitada para a estrutura IP_ADAPTER_UNICAST_ADDRESS . Ao compilar um aplicativo se a plataforma de destino não for o Windows Vista e posterior, a estrutura IP_ADAPTER_UNICAST_ADDRESS_XP será digitada para a estrutura IP_ADAPTER_UNICAST_ADDRESS .

A estrutura SOCKET_ADDRESS é usada na estrutura IP_ADAPTER_UNICAST_ADDRESS . No Microsoft Windows Software Development Kit (SDK) lançado para Windows Vista e posteriores, a organização dos arquivos de cabeçalho foi alterada e a estrutura de SOCKET_ADDRESS é definida no arquivo de cabeçalho Ws2def.h , que é incluído automaticamente pelo arquivo de cabeçalho Winsock2.h . No SDK (Platform Software Development Kit) lançado para Windows Server 2003 e Windows XP, a estrutura SOCKET_ADDRESS é declarada no arquivo de cabeçalho Winsock2.h . Para usar a estrutura IP_ADAPTER_UNICAST_ADDRESS , o arquivo de cabeçalho Winsock2.h deve ser incluído antes do arquivo de cabeçalho Iphlpapi.h .

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	iptypes.h (inclua Iphlpapi.h)