Compartilhar via

estrutura DNS_CUSTOM_SERVER (windns.h)

  • Artigo

Representa um servidor personalizado DNS. Um objeto DNS_CUSTOM_SERVER é passado para DnsQueryEx por meio da estrutura DNS_QUERY_REQUEST3.

Para usar DNS_CUSTOM_SERVER junto com ServerAddr, inclua ws2ipdef.h antes de windns.h.

Sintaxe

typedef struct _DNS_CUSTOM_SERVER {
  DWORD   dwServerType;
  ULONG64 ullFlags;
  union {
    PWSTR pwszTemplate;
    PWSTR pwszHostname;
  };
  CHAR    MaxSa[DNS_ADDR_MAX_SOCKADDR_LENGTH];
} DNS_CUSTOM_SERVER;

Membros

dwServerType

Tipo: DWORD

O tipo de servidor. Deve ser um dos seguintes.

Valor Descrição
DNS_CUSTOM_SERVER_TYPE_UDP 0x1 Executar resolução de nomes não seguros
DNS_CUSTOM_SERVER_TYPE_DOH 0x2 Executar resolução de nomes de DNS sobre HTTPS

ullFlags

Tipo: ULONG64

Um valor que contém um bitmap das opções a seguir.

Valor Descrição
DNS_CUSTOM_SERVER_UDP_FALLBACK 0x1 O servidor pode voltar à resolução não seguras

pwszTemplate

Tipo: PWSTR

Uma cadeia de caracteres NULLlarga terminada que representa o modelo de DNS sobre HTTPS .

Se dwServerType estiver definido como DNS_CUSTOM_SERVER_TYPE_UDP, esse campo deverá ser NULL.

Se dwServerType estiver definido como DNS_CUSTOM_SERVER_TYPE_DOH, esse campo deverá apontar para uma cadeia de caracteres nulanula válida .

pwszHostname

MaxSa[DNS_ADDR_MAX_SOCKADDR_LENGTH]

Tipo: CHAR [DNS_ADDR_MAX_SOCKADDR_LENGTH]

Uma matriz de bytes, que designa o armazenamento para um SOCKADDR_INET. maxsa é uma união com ServerAddr.

Para usar DNS_CUSTOM_SERVER junto com ServerAddr, você deve incluir ws2ipdef.h antes de windns.h.

Além do armazenamento do SOCKADDR_INET, maxsa evita erros de compilação causados por não incluindo ws2ipdef.h. Isso permite que você use qualquer funcionalidade de windns.h exceto o DNS_CUSTOM_SERVER.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Build 22000
servidor com suporte mínimo Windows Build 22000
cabeçalho windns.h

Consulte também