структура DNS_CUSTOM_SERVER (windns.h)

  • Статья

Представляет пользовательский DNS-сервер. Объект DNS_CUSTOM_SERVER передается в DnsQueryEx через структуру DNS_QUERY_REQUEST3 .

Чтобы использовать DNS_CUSTOM_SERVER вместе с ServerAddr, добавьте ws2ipdef.h перед windns.h.

Синтаксис

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

Члены

dwServerType

Тип: DWORD

Тип сервера. Должен быть одним из следующих вариантов.

Значение Описание
DNS_CUSTOM_SERVER_TYPE_UDP 0x1 Выполнение небезопасного разрешения имен
DNS_CUSTOM_SERVER_TYPE_DOH 0x2 Выполнение разрешения имен DNS-over-HTTPS

ullFlags

Тип: ULONG64

Значение типа , содержащее растровое изображение следующих параметров.

Значение Описание
DNS_CUSTOM_SERVER_UDP_FALLBACK 0x1 Сервер может вернуться к небезопасным разрешениям

pwszTemplate

Тип: PWSTR

Строка с завершением NULL, представляющая шаблон DNS-over-HTTPS .

Если параметру dwServerType присвоено значение DNS_CUSTOM_SERVER_TYPE_UDP, это поле должно иметь значение NULL.

Если параметру dwServerType присвоено значение DNS_CUSTOM_SERVER_TYPE_DOH, это поле должно указывать на допустимую строку, завершаемую значением NULL.

pwszHostname

MaxSa[DNS_ADDR_MAX_SOCKADDR_LENGTH]

Тип: CHAR[DNS_ADDR_MAX_SOCKADDR_LENGTH]

Массив байтов, который обозначает хранилище для SOCKADDR_INET. MaxSa является объединением с ServerAddr.

Чтобы использовать DNS_CUSTOM_SERVER вместе с ServerAddr, необходимо включить ws2ipdef.h перед windns.h.

Помимо хранилища для SOCKADDR_INET, MaxSa позволяет избежать ошибок компиляции, вызванных отсутствиемws2ipdef.h. Это позволяет использовать любые функциональные возможности, windns.h кроме DNS_CUSTOM_SERVER.

Требования

   
Минимальная версия клиента Сборка Windows 22000
Минимальная версия сервера Сборка Windows 22000
Верхняя часть windns.h

См. также раздел