DNS_RECORDW結構（windns.h）

發行項
11/12/2024

DNS_RECORD 結構會儲存 DNS 資源記錄（RR）。

語法

typedef struct _DnsRecordW {
  struct _DnsRecordW *pNext;
  PWSTR              pName;
  WORD               wType;
  WORD               wDataLength;
  union {
    DWORD            DW;
    DNS_RECORD_FLAGS S;
  } Flags;
  DWORD              dwTtl;
  DWORD              dwReserved;
  union {
    DNS_A_DATA          A;
    DNS_SOA_DATAW       SOA;
    DNS_SOA_DATAW       Soa;
    DNS_PTR_DATAW       PTR;
    DNS_PTR_DATAW       Ptr;
    DNS_PTR_DATAW       NS;
    DNS_PTR_DATAW       Ns;
    DNS_PTR_DATAW       CNAME;
    DNS_PTR_DATAW       Cname;
    DNS_PTR_DATAW       DNAME;
    DNS_PTR_DATAW       Dname;
    DNS_PTR_DATAW       MB;
    DNS_PTR_DATAW       Mb;
    DNS_PTR_DATAW       MD;
    DNS_PTR_DATAW       Md;
    DNS_PTR_DATAW       MF;
    DNS_PTR_DATAW       Mf;
    DNS_PTR_DATAW       MG;
    DNS_PTR_DATAW       Mg;
    DNS_PTR_DATAW       MR;
    DNS_PTR_DATAW       Mr;
    DNS_MINFO_DATAW     MINFO;
    DNS_MINFO_DATAW     Minfo;
    DNS_MINFO_DATAW     RP;
    DNS_MINFO_DATAW     Rp;
    DNS_MX_DATAW        MX;
    DNS_MX_DATAW        Mx;
    DNS_MX_DATAW        AFSDB;
    DNS_MX_DATAW        Afsdb;
    DNS_MX_DATAW        RT;
    DNS_MX_DATAW        Rt;
    DNS_TXT_DATAW       HINFO;
    DNS_TXT_DATAW       Hinfo;
    DNS_TXT_DATAW       ISDN;
    DNS_TXT_DATAW       Isdn;
    DNS_TXT_DATAW       TXT;
    DNS_TXT_DATAW       Txt;
    DNS_TXT_DATAW       X25;
    DNS_NULL_DATA       Null;
    DNS_WKS_DATA        WKS;
    DNS_WKS_DATA        Wks;
    DNS_AAAA_DATA       AAAA;
    DNS_KEY_DATA        KEY;
    DNS_KEY_DATA        Key;
    DNS_SIG_DATAW       SIG;
    DNS_SIG_DATAW       Sig;
    DNS_ATMA_DATA       ATMA;
    DNS_ATMA_DATA       Atma;
    DNS_NXT_DATAW       NXT;
    DNS_NXT_DATAW       Nxt;
    DNS_SRV_DATAW       SRV;
    DNS_SRV_DATAW       Srv;
    DNS_NAPTR_DATAW     NAPTR;
    DNS_NAPTR_DATAW     Naptr;
    DNS_OPT_DATA        OPT;
    DNS_OPT_DATA        Opt;
    DNS_DS_DATA         DS;
    DNS_DS_DATA         Ds;
    DNS_RRSIG_DATAW     RRSIG;
    DNS_RRSIG_DATAW     Rrsig;
    DNS_NSEC_DATAW      NSEC;
    DNS_NSEC_DATAW      Nsec;
    DNS_DNSKEY_DATA     DNSKEY;
    DNS_DNSKEY_DATA     Dnskey;
    DNS_TKEY_DATAW      TKEY;
    DNS_TKEY_DATAW      Tkey;
    DNS_TSIG_DATAW      TSIG;
    DNS_TSIG_DATAW      Tsig;
    DNS_WINS_DATA       WINS;
    DNS_WINS_DATA       Wins;
    DNS_WINSR_DATAW     WINSR;
    DNS_WINSR_DATAW     WinsR;
    DNS_WINSR_DATAW     NBSTAT;
    DNS_WINSR_DATAW     Nbstat;
    DNS_DHCID_DATA      DHCID;
    DNS_NSEC3_DATA      NSEC3;
    DNS_NSEC3_DATA      Nsec3;
    DNS_NSEC3PARAM_DATA NSEC3PARAM;
    DNS_NSEC3PARAM_DATA Nsec3Param;
    DNS_TLSA_DATA       TLSA;
    DNS_TLSA_DATA       Tlsa;
    DNS_SVCB_DATA       SVCB;
    DNS_SVCB_DATA       Svcb;
    DNS_UNKNOWN_DATA    UNKNOWN;
    DNS_UNKNOWN_DATA    Unknown;
    PBYTE               pDataPtr;
  } Data;
} DNS_RECORDW, *PDNS_RECORDW;

成員

pNext

下一個 DNS_RECORD 結構的指標。

pName

字串的指標，表示記錄集的功能變數名稱。這必須是對應至所呼叫函式的字串格式，例如 ANSI、Unicode 或 UTF8。

wType

值，表示 RR DNS 記錄類型。 wType 會決定 Data的格式。例如，如果 wType 的值 DNS_TYPE_A，則 data 的數據類型 DNS_A_DATA。

wDataLength

Data的長度，以位元組為單位。對於固定長度數據類型，這個值是對應資料類型的大小，例如 sizeof（DNS_A_DATA）。針對非固定數據類型，請使用下列其中一個巨集來判斷數據的長度：

C++
#include <windows.h> #define DNS_NULL_RECORD_LENGTH(ByteCount) (sizeof(DWORD) + (ByteCount)) #define DNS_WKS_RECORD_LENGTH(ByteCount) (sizeof(DNS_WKS_DATA) + (ByteCount-1)) #define DNS_WINS_RECORD_LENGTH(IpCount) (sizeof(DNS_WINS_DATA) + ((IpCount-1) * sizeof(IP_ADDRESS))) #define DNS_TEXT_RECORD_LENGTH(StringCount) (sizeof(DWORD) + ((StringCount) * sizeof(PCHAR)))

C++

#include <windows.h>
#define DNS_NULL_RECORD_LENGTH(ByteCount) (sizeof(DWORD) + (ByteCount))
#define DNS_WKS_RECORD_LENGTH(ByteCount) (sizeof(DNS_WKS_DATA) + (ByteCount-1))
#define DNS_WINS_RECORD_LENGTH(IpCount) (sizeof(DNS_WINS_DATA) + ((IpCount-1) * sizeof(IP_ADDRESS)))
#define DNS_TEXT_RECORD_LENGTH(StringCount) (sizeof(DWORD) + ((StringCount) * sizeof(PCHAR)))

Flags

Flags.DW

值，包含 DNS 記錄旗標的點陣圖。

Flags.S

一組旗標，格式為 DNS_RECORD_FLAGS 結構。

dwTtl

DNS RR 的存留時間值（TTL），以秒為單位。

dwReserved

保留。請勿使用。

Data

DNS RR 數據類型是由 wType 所決定，而且是下列其中一個成員：

SOA、Soa

RR 資料類型 DNS_SOA_DATA。 wType 的值是 DNS_TYPE_SOA。

PTR、Ptr、NS、Ns、CNAME、Cname、DNAME、Dname、MB、Mb、MD、Md、MF、Mf、MG、MG、MR、Mr、Mr

RR 資料類型 DNS_PTR_DATA。 wType 的值 DNS_TYPE_PTR。

MINFO、Minfo、RP、Rp

RR 資料類型 DNS_MINFO_DATA。 wType 的值是 DNS_TYPE_MINFO。

MX、Mx、AFSDB、Afsdb、RT、Rt

RR 資料類型 DNS_MX_DATA。 wType 的值是 DNS_TYPE_MX。

HINFO、Hinfo、ISDN、Isdn、TXT、Txt、X25

RR 資料類型 DNS_TXT_DATA。 wType 的值是 DNS_TYPE_TEXT。

WKS、Wks

RR 資料類型 DNS_WKS_DATA。 wType 的值 DNS_TYPE_WKS。

KEY、Key

RR 資料類型 DNS_KEY_DATA。 wType 的值是 DNS_TYPE_KEY。

SIG、Sig

RR 資料類型 DNS_SIG_DATA。 wType 的值是 DNS_TYPE_SIG。

ATMA、Atma

RR 資料類型 DNS_ATMA_DATA。 wType 的值是 DNS_TYPE_ATMA。

NXT、Nxt

RR 資料類型 DNS_NXT_DATA。 wType 的值是 DNS_TYPE_NXT。

SRV、Srv

RR 資料類型 DNS_SRV_DATA。 wType 的值 DNS_TYPE_SRV。

NAPTR、Naptr

RR 資料類型 DNS_NAPTR_DATA。 wType 的值是 DNS_TYPE_NAPTR。

OPT、Opt

Windows 7 或更新版本：RR 數據類型 DNS_OPT_DATA。 wType 的值是 DNS_TYPE_OPT。

DS、Ds

Windows 7 或更新版本：RR 數據類型 DNS_DS_DATA。 wType 的值是 DNS_TYPE_DS。

RRSIG、Rrsig

Windows 7 或更新版本：RR 數據類型 DNS_RRSIG_DATA。 wType 的值 DNS_TYPE_RRSIG。

NSEC、Nsec

Windows 7 或更新版本：RR 數據類型 DNS_NSEC_DATA。 wType 的值是 DNS_TYPE_NSEC。

DNSKEY、Dnskey

Windows 7 或更新版本：RR 數據類型 DNS_DNSKEY_DATA。 wType 的值是 DNS_TYPE_DNSKEY。

TKEY、Tkey

RR 資料類型 DNS_TKEY_DATA。 wType 的值是 DNS_TYPE_TKEY。

TSIG、Tsig

RR 資料類型 DNS_TSIG_DATA。 wType 的值是 DNS_TYPE_TSIG。

WINS、Wins

RR 資料類型 DNS_WINS_DATA。 wType 的值是 DNS_TYPE_WINS。

WINSR、WinsR、NBSTAT、Nbstat

RR 資料類型 DNS_WINSR_DATA。 wType 的值是 DNS_TYPE_WINSR。

Data.A

RR 資料類型 DNS_A_DATA。 wType 的值是 DNS_TYPE_A。

Data.SOA

Data.Soa

Data.PTR

Data.Ptr

Data.NS

Data.Ns

Data.CNAME

Data.Cname

Data.DNAME

Data.Dname

Data.MB

Data.Mb

Data.MD

Data.Md

Data.MF

Data.Mf

Data.MG

Data.Mg

Data.MR

Data.Mr

Data.MINFO

Data.Minfo

Data.RP

Data.Rp

Data.MX

Data.Mx

Data.AFSDB

Data.Afsdb

Data.RT

Data.Rt

Data.HINFO

Data.Hinfo

Data.ISDN

Data.Isdn

Data.TXT

Data.Txt

Data.X25

Data.Null

RR 資料類型 DNS_NULL_DATA。 wType 的值是 DNS_TYPE_NULL。

Data.WKS

Data.Wks

Data.AAAA

RR 資料類型 DNS_AAAA_DATA。 wType 的值是 DNS_TYPE_AAAA。

Data.KEY

Data.Key

Data.SIG

Data.Sig

Data.ATMA

Data.Atma

Data.NXT

Data.Nxt

Data.SRV

Data.Srv

Data.NAPTR

Data.Naptr

Data.OPT

Data.Opt

Data.DS

Data.Ds

Data.RRSIG

Data.Rrsig

Data.NSEC

Data.Nsec

Data.DNSKEY

Data.Dnskey

Data.TKEY

Data.Tkey

Data.TSIG

Data.Tsig

Data.WINS

Data.Wins

Data.WINSR

Data.WinsR

Data.NBSTAT

Data.Nbstat

Data.DHCID

Windows 7 或更新版本：RR 數據類型 DNS_DHCID_DATA。 wType 的值是 DNS_TYPE_DHCID。

Data.NSEC3

Data.Nsec3

Data.NSEC3PARAM

Data.Nsec3Param

Data.TLSA

Data.Tlsa

Data.SVCB

Data.Svcb

Data.UNKNOWN

Data.Unknown

Data.pDataPtr

言論

建置 DNS_RECORD 清單作為 DNS API 中找到之各種 DNS 更新例程的輸入自變數時，DNS_RECORD 結構中的所有旗標都應該設定為零。

注意

windns.h 標頭會將 DNS_RECORD定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	windns.h