estrutura ADDRINFO_DNS_SERVER (ws2def.h)

  • Artigo

Representa um servidor DNS (Sistema de Nomes de Domínio) personalizado, usado nas APIs winsock.

Sintaxe

typedef struct addrinfo_dns_server {
  unsigned int     ai_servertype;
  unsigned __int64 ai_flags;
  unsigned int     ai_addrlen;
  struct sockaddr  *ai_addr;
  union {
    PWSTR ai_template;
  };
} ADDRINFO_DNS_SERVER;

Membros

ai_servertype

O tipo de servidor DNS. Pode ser um dos valores a seguir.

Constante Valor Significado
AI_DNS_SERVER_TYPE_UDP 1 Um servidor DNS normal.
AI_DNS_SERVER_TYPE_DOH 2 Um servidor DNS-over-HTTPS .

ai_flags

Um bitmap que contém qualquer uma das opções a seguir.

Constante Valor Significado
AI_DNS_SERVER_UDP_FALLBACK 0x1 Esse servidor também pode ser usado para resolução de nomes não seguros.

ai_addrlen

O comprimento em bytes da estrutura de endereço do soquete que ai_addr aponta.

ai_addr

Um ponteiro para uma estrutura de endereço de soquete que contém o endereço do servidor personalizado. Há suporte apenas para estruturas de SOCKADDR_IN e SOCKADDR_IN6 . O membro sa_family deve ser definido como AF_INET ou AF_INET6. O restante da estrutura deve ser zerado, com exceção do membro SOCKADDR_IN::sin_addr para IPv4 ou SOCKADDR_IN6::sin6_addr para IPv6.

ai_template

Se ai_servertype estiver definido como AI_DNS_SERVER_TYPE_DOH, esse membro deverá apontar para uma cadeia de caracteres larga terminada em NULL que representa o modelo DNS-over-HTTPS para este servidor.

Se ai_servertype estiver definido como AI_DNS_SERVER_TYPE_UDP, esse campo deverá ser NULL.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Build 22000
Servidor mínimo com suporte Windows Build 22000
Cabeçalho ws2def.h

Confira também