estrutura IP_ADAPTER_UNICAST_ADDRESS_LH (iptypes.h)
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 .
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.
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 >= 0x0600
ou 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) |
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de