ADDRINFOEX2W estrutura (ws2def.h)
A estrutura addrinfoex2 é usada pela função GetAddrInfoEx para armazenar informações de endereço do host quando um nome canônico e um nome de domínio totalmente qualificado tiverem sido solicitados.
Sintaxe
typedef struct addrinfoex2W {
int ai_flags;
int ai_family;
int ai_socktype;
int ai_protocol;
size_t ai_addrlen;
PWSTR ai_canonname;
struct sockaddr *ai_addr;
void *ai_blob;
size_t ai_bloblen;
LPGUID ai_provider;
struct addrinfoex2W *ai_next;
int ai_version;
PWSTR ai_fqdn;
} ADDRINFOEX2W, *PADDRINFOEX2W, *LPADDRINFOEX2W;
Membros
ai_flags
Sinalizadores que indicam as opções usadas na função getAddrInfoEx.
Os valores com suporte para o membro ai_flags são definidos no winsock2.h incluir arquivo e podem ser uma combinação das opções a seguir.
| Valor | Significado |
|---|---|
|
O endereço do soquete será usado em uma chamada para a função associar. |
|
O nome canônico é retornado no primeiro membro ai_canonname. |
|
O parâmetro nodename passado para a função GetAddrInfoEx deve ser uma cadeia de caracteres numérica. |
|
Se esse bit estiver definido, uma solicitação será feita para endereços IPv6 e endereços IPv4 com AI_V4MAPPED.
Essa opção tem suporte no Windows Vista e posterior. |
|
O GetAddrInfoEx será resolvido somente se um endereço global estiver configurado. O endereço de loopback IPv6 e IPv4 não é considerado um endereço global válido.
Essa opção tem suporte no Windows Vista e posterior. |
|
Se a solicitação GetAddrInfoEx para um endereço IPv6 falhar, uma solicitação de serviço de nome será feita para endereços IPv4 e esses endereços serão convertidos no formato de endereço IPv6 mapeado para IPv4.
Essa opção tem suporte no Windows Vista e posterior. |
|
As informações de endereço são de resultados não autoritativos.
Quando essa opção é definida no parâmetro pHints de GetAddrInfoEx, o provedor de namespace NS_EMAIL retorna resultados autoritativos e não autoritativos. Se essa opção não estiver definida, somente os resultados autoritativos serão retornados. Essa opção só tem suporte no Windows Vista e posterior para o namespace NS_EMAIL. |
|
As informações de endereço são de um canal seguro.
Se o AI_SECURE bit estiver definido, o provedor de namespace NS_EMAIL retornará os resultados obtidos com segurança aprimorada para minimizar possíveis falsificações. Quando essa opção é definida no parâmetro pHints de GetAddrInfoEx, o provedor de namespace NS_EMAIL retorna apenas os resultados obtidos com segurança aprimorada para minimizar possíveis falsificações. Essa opção só tem suporte no Windows Vista e posterior para o namespace NS_EMAIL. |
|
As informações de endereço são para nomes preferenciais para publicação com um namespace específico.
Quando essa opção é definida no parâmetro pHints de GetAddrInfoEx, nenhum nome deve ser fornecido no parâmetro pName e o provedor de namespace NS_EMAIL retornará nomes preferenciais para publicação. Essa opção só tem suporte no Windows Vista e posterior para o namespace NS_EMAIL. |
|
O nome de domínio totalmente qualificado é retornado no primeiro membro ai_fqdn.
Quando essa opção é definida no parâmetro pHints de GetAddrInfoEx e um nome simples (rótulo único) é especificado no parâmetro pName, o nome de domínio totalmente qualificado ao qual o nome acabou sendo resolvido será retornado. Essa opção tem suporte no Windows 7, Windows Server 2008 R2 e posterior. |
|
Uma dica para o provedor de namespace que o nome do host está sendo consultado está sendo usada em um cenário de compartilhamento de arquivos. O provedor de namespace pode ignorar essa dica.
Essa opção tem suporte no Windows 7, Windows Server 2008 R2 e posterior. |
|
Desabilite a codificação automática de Nome de Domínio Internacional usando Punycode nas funções de resolução de nomes chamadas pela função GetAddrInfoEx.
Essa opção tem suporte no Windows 8, Windows Server 2012 e posterior. |
ai_family
A família de endereços.
Os valores possíveis para a família de endereços são definidos no arquivo de cabeçalho Ws2def.h. Observe que o arquivo de cabeçalho Ws2def.h é incluído automaticamente no Winsock2.h e nunca deve ser usado diretamente.
Os valores atualmente compatíveis são AF_INET ou AF_INET6, que são os formatos de família de endereços da Internet para IPv4 e IPv6. Outras opções para a família de endereços (AF_NETBIOS para uso com NetBIOS, por exemplo) têm suporte se um provedor de serviços do Windows Sockets para a família de endereços estiver instalado. Observe que os valores para a família de endereços AF_ e as constantes da família de protocolos PF_ são idênticos (por exemplo, AF_INET e PF_INET), portanto, qualquer constante pode ser usada.
A tabela a seguir lista valores comuns para a família de endereços, embora muitos outros valores sejam possíveis.
ai_socktype
O tipo de soquete. Os valores possíveis para o tipo de soquete são definidos no arquivo de inclusão Winsock2.h.
A tabela a seguir lista os valores possíveis para o tipo de soquete compatível com o Windows Sockets 2:
| Valor | Significado |
|---|---|
|
Fornece fluxos de bytes sequenciados, confiáveis, bidirecionais e baseados em conexão com um mecanismo de transmissão de dados OOB. Usa o TCP (Protocolo de Controle de Transmissão) para a família de endereços da Internet (AF_INET ou AF_INET6). Se o membro ai_family for AF_IRDA, SOCK_STREAM será o único tipo de soquete com suporte. |
|
Dá suporte a datagrams, que são buffers não confiáveis e sem conexão de um comprimento máximo fixo (normalmente pequeno). Usa o UDP (User Datagram Protocol) para a família de endereços da Internet (AF_INET ou AF_INET6). |
|
Fornece um soquete bruto que permite que um aplicativo manipule o próximo cabeçalho de protocolo de camada superior. Para manipular o cabeçalho IPv4, a opção de soquete IP_HDRINCL deve ser definida no soquete. Para manipular o cabeçalho IPv6, a opção IPV6_HDRINCL soquete deve ser definida no soquete. |
|
Fornece um datagrama de mensagem confiável. Um exemplo desse tipo é a implementação de protocolo multicast (PGM) pragmática no Windows, geralmente conhecida como programação multicast confiável. |
|
Fornece um pacote pseudo-fluxo com base em datagramas. |
No Windows Sockets 2, novos tipos de soquete foram introduzidos. Um aplicativo pode descobrir dinamicamente os atributos de cada protocolo de transporte disponível por meio da função WSAEnumProtocols. Portanto, um aplicativo pode determinar as possíveis opções de tipo de soquete e protocolo para uma família de endereços e usar essas informações ao especificar esse parâmetro. As definições de tipo de soquete no Winsock2.h e arquivos de cabeçalho Ws2def.h serão atualizadas periodicamente à medida que novos tipos de soquete, famílias de endereços e protocolos forem definidos.
No Windows Sockets 1.1, os únicos tipos de soquete possíveis são SOCK_DATAGRAM e SOCK_STREAM.
ai_protocol
O tipo de protocolo. As opções possíveis são específicas para a família de endereços e o tipo de soquete especificados. Os valores possíveis para o ai_protocol são definidos em Winsock2.h e nos arquivos de cabeçalho do Wsrm.h.
No SDK do Windows lançado para Windows Vista e posterior, a organização dos arquivos de cabeçalho foi alterada e esse membro pode ser um dos valores do tipo de enumeração IPPROTO definido no arquivo de cabeçalho Ws2def.h. Observe que o arquivo de cabeçalho Ws2def.h é incluído automaticamente no Winsock2.h e nunca deve ser usado diretamente.
Se um valor de 0 for especificado para ai_protocol, o chamador não deseja especificar um protocolo e o provedor de serviços escolherá o ai_protocol a ser usado. Para protocolos diferentes de IPv4 e IPv6, defina ai_protocol como zero.
A tabela a seguir lista valores comuns para o membro ai_protocol, embora muitos outros valores sejam possíveis.
Se o membro ai_family for AF_IRDA, o ai_protocol deverá ser 0.
ai_addrlen
O comprimento, em bytes, do buffer apontado pelo membro ai_addr.
ai_canonname
O nome canônico do host.
ai_addr
Um ponteiro para uma estrutura de de soquete. O membro ai_addr em cada um retornado a estrutura de addrinfoex2 aponta para uma estrutura de endereço de soquete preenchida. O comprimento, em bytes, de cada estrutura addrinfoex2 retornada é especificado no membro ai_addrlen.
ai_blob
Um ponteiro para dados usados para retornar informações de namespace específicas do provedor associadas ao nome além de uma lista de endereços. O comprimento, em bytes, do buffer apontado por ai_blob deve ser especificado no membro ai_bloblen.
ai_bloblen
O comprimento, em bytes, do membro ai_blob.
ai_provider
Um ponteiro para o GUID de um provedor de namespace específico.
ai_next
Um ponteiro para a próxima estrutura em uma lista vinculada. Esse parâmetro é definido como NULL na estrutura de addrinfoex2 da última de uma lista vinculada.
ai_version
O número de versão dessa estrutura. O valor atualmente usado para esta versão da estrutura é 2.
ai_fqdn
O nome de domínio totalmente qualificado para o host.
Observações
A estrutura de addrinfoex2 tem suporte no Windows 8 e no Windows Server 2012
A estrutura addrinfoex2 é usada pela função GetAddrInfoEx para armazenar informações de endereço do host quando os bits AI_FQDN e AI_CANONNAME são definidos no membro ai_flags da estrutura addrinfoex opcional fornecida no parâmetro dicas para a função GetAddrInfoEx. A estrutura addrinfoex2 é uma versão aprimorada da estrutura do addrinfoex que pode retornar o nome canônico e o nome de domínio totalmente qualificado para o host. Os membros de estrutura extra são para um número de versão da estrutura e o nome de domínio totalmente qualificado para o host.
A estrutura de addrinfoex2 usada com função GetAddrInfoEx é uma versão aprimorada das estruturas addrinfo e addrinfoW usadas com as funções getaddrinfo e GetAddrInfoW. A função GetAddrInfoEx permite especificar o provedor de namespace para resolver a consulta. Para uso com o protocolo IPv6 e IPv4, a resolução de nomes pode ser pelo DNS (Sistema de Nomes de Domínio), um local hospeda arquivo, um provedor de email (o namespace NS_EMAIL) ou por outros mecanismos de nomenclatura.
Os dados de blob em tha ai_blob membro são usados para retornar informações adicionais de namespace específicas do provedor associadas a um nome. O formato de dados no membro ai_blob é específico para um provedor de namespace específico. Atualmente, os dados de blob são usados pelo provedor de namespace NS_EMAIL para fornecer informações adicionais.
Quando UNICODE ou _UNICODE é definido, addrinfoex2 é definido como addrinfoex2W, a versão Unicode dessa estrutura. Os parâmetros de cadeia de caracteres são definidos para o tipo de dados PWSTR e a estrutura addrinfoex2W é usada.
Quando UNICODE ou _UNICODE não é definido, addrinfoex2 é definido como addrinfoex2A, a versão ANSI dessa estrutura. Os parâmetros de cadeia de caracteres são do tipo de dados char * e a estrutura addrinfoex2A é usada.
Após uma chamada bem-sucedida para GetAddrInfoEx, uma lista vinculada de estruturas de addrinfoex2 é retornada no parâmetro ppResult passado para a função GetAddrInfoEx. A lista pode ser processada seguindo o ponteiro fornecido no membro ai_next de cada addrinfoex2 retornado até que um ponteiro NULL seja encontrado. Em cada estrutura de addrinfoex2 retornada, os membros ai_family, ai_socktypee ai_protocol correspondem aos respectivos argumentos em uma chamada de função de soquete ou WSASocket. Além disso, o membro ai_addr em cada um retornado estrutura addrinfoex2 aponta para uma estrutura de endereço de soquete preenchida, o comprimento do qual é especificado em seu membro ai_addrlen.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8 [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2012 [somente aplicativos da área de trabalho] |
| cabeçalho | ws2def.h |