DNS_RECORDA 構造体 (windns.h)

[アーティクル]
08/27/2023

DNS_RECORD構造体には、DNS リソースレコード (RR) が格納されます。

構文

typedef struct _DnsRecordA {
  struct _DnsRecordA *pNext;
  PSTR               pName;
  WORD               wType;
  WORD               wDataLength;
  union {
    DWORD            DW;
    DNS_RECORD_FLAGS S;
  } Flags;
  DWORD              dwTtl;
  DWORD              dwReserved;
  union {
    DNS_A_DATA          A;
    DNS_SOA_DATAA       SOA;
    DNS_SOA_DATAA       Soa;
    DNS_PTR_DATAA       PTR;
    DNS_PTR_DATAA       Ptr;
    DNS_PTR_DATAA       NS;
    DNS_PTR_DATAA       Ns;
    DNS_PTR_DATAA       CNAME;
    DNS_PTR_DATAA       Cname;
    DNS_PTR_DATAA       DNAME;
    DNS_PTR_DATAA       Dname;
    DNS_PTR_DATAA       MB;
    DNS_PTR_DATAA       Mb;
    DNS_PTR_DATAA       MD;
    DNS_PTR_DATAA       Md;
    DNS_PTR_DATAA       MF;
    DNS_PTR_DATAA       Mf;
    DNS_PTR_DATAA       MG;
    DNS_PTR_DATAA       Mg;
    DNS_PTR_DATAA       MR;
    DNS_PTR_DATAA       Mr;
    DNS_MINFO_DATAA     MINFO;
    DNS_MINFO_DATAA     Minfo;
    DNS_MINFO_DATAA     RP;
    DNS_MINFO_DATAA     Rp;
    DNS_MX_DATAA        MX;
    DNS_MX_DATAA        Mx;
    DNS_MX_DATAA        AFSDB;
    DNS_MX_DATAA        Afsdb;
    DNS_MX_DATAA        RT;
    DNS_MX_DATAA        Rt;
    DNS_TXT_DATAA       HINFO;
    DNS_TXT_DATAA       Hinfo;
    DNS_TXT_DATAA       ISDN;
    DNS_TXT_DATAA       Isdn;
    DNS_TXT_DATAA       TXT;
    DNS_TXT_DATAA       Txt;
    DNS_TXT_DATAA       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_DATAA       SIG;
    DNS_SIG_DATAA       Sig;
    DNS_ATMA_DATA       ATMA;
    DNS_ATMA_DATA       Atma;
    DNS_NXT_DATAA       NXT;
    DNS_NXT_DATAA       Nxt;
    DNS_SRV_DATAA       SRV;
    DNS_SRV_DATAA       Srv;
    DNS_NAPTR_DATAA     NAPTR;
    DNS_NAPTR_DATAA     Naptr;
    DNS_OPT_DATA        OPT;
    DNS_OPT_DATA        Opt;
    DNS_DS_DATA         DS;
    DNS_DS_DATA         Ds;
    DNS_RRSIG_DATAA     RRSIG;
    DNS_RRSIG_DATAA     Rrsig;
    DNS_NSEC_DATAA      NSEC;
    DNS_NSEC_DATAA      Nsec;
    DNS_DNSKEY_DATA     DNSKEY;
    DNS_DNSKEY_DATA     Dnskey;
    DNS_TKEY_DATAA      TKEY;
    DNS_TKEY_DATAA      Tkey;
    DNS_TSIG_DATAA      TSIG;
    DNS_TSIG_DATAA      Tsig;
    DNS_WINS_DATA       WINS;
    DNS_WINS_DATA       Wins;
    DNS_WINSR_DATAA     WINSR;
    DNS_WINSR_DATAA     WinsR;
    DNS_WINSR_DATAA     NBSTAT;
    DNS_WINSR_DATAA     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_RECORDA, *PDNS_RECORDA;

メンバー

pNext

次の DNS_RECORD 構造体へのポインター。

pName

レコードセットのドメイン名を表す文字列へのポインター。これは、ANSI、Unicode、UTF8 など、という関数に対応する文字列形式である必要があります。

wType

RR DNS レコードの種類を表す値。 wType は 、データの形式を決定します。たとえば、 wType の値が DNS_TYPE_A場合、 Data のデータ型は DNS_A_DATA。

wDataLength

データの長さ (バイト単位)。固定長データ型の場合、この値は sizeof(DNS_A_DATA) などの対応するデータ型のサイズです。非固定データ型の場合は、次のいずれかのマクロを使用して、データの長さを確認します。

C++
<windows.h の #include> #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++

<windows.h の #include>
#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 の Time To Live 値 (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

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 API で見つかったさまざまな DNS 更新ルーチンの入力引数として DNS_RECORD リストを作成する場合は、 DNS_RECORD 構造体内のすべてのフラグを 0 に設定する必要があります。

注意

windns.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとしてDNS_RECORDを定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
Header	windns.h