共用方式為

DNS_CUSTOM_SERVER結構（windnsdef.h）

  • 發行項

表示 DNS 自定義伺服器。 DNS_CUSTOM_SERVER 物件會透過 DNS_QUERY_REQUEST3 結構傳遞至 DnsQueryEx。

若要搭配 ServerAddr使用 DNS_CUSTOM_SERVER，請在 windns.h之前包含 ws2ipdef.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

代表 dns-over-HTTPS 範本 的 NULL終止寬字串。

如果 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的聯集。

若要搭配 ServerAddr使用 DNS_CUSTOM_SERVER，您必須在 windns.h之前包含 ws2ipdef.h。

除了 SOCKADDR_INET的記憶體，MaxSa 可避免編譯錯誤，不包含ws2ipdef.h。 這可讓您從 windns.h 使用任何功能，但 DNS_CUSTOM_SERVER除外。

要求

要求 價值
最低支援的用戶端 Windows 組建 22000
支援的最低伺服器 Windows 組建 22000
標頭 windnsdef.h

另請參閱