Freigeben über

DNS_RECORDW Struktur (windns.h)

  • Artikel

Die DNS_RECORD-Struktur speichert einen DNS-Ressourceneintrag (RR).

Syntax

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;

Angehörige

pNext

Ein Zeiger auf die nächste DNS_RECORD Struktur.

pName

Ein Zeiger auf eine Zeichenfolge, die den Domänennamen des Datensatzsatzes darstellt. Dies muss im Zeichenfolgenformat vorliegen, das der aufgerufenen Funktion entspricht, z. B. ANSI, Unicode oder UTF8.

wType

Ein Wert, der den RR-DNS-Eintragstypdarstellt. wType- bestimmt das Format Data. Wenn beispielsweise der Wert von wType-DNS_TYPE_Aist, wird der Datentyp DataDNS_A_DATA.

wDataLength

Die Länge in Byte von Data. Bei Datentypen mit fester Länge ist dieser Wert die Größe des entsprechenden Datentyps, z. B. Sizeof(DNS_A_DATA). Verwenden Sie für die nicht festen Datentypen eines der folgenden Makros, um die Länge der Daten zu bestimmen:

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

Ein Wert, der eine Bitmap DNS-Eintragskennzeichnungenenthält.

Flags.S

Eine Reihe von Kennzeichen in Form einer DNS_RECORD_FLAGS Struktur.

dwTtl

Der TIME To Live-Wert (TTL) des DNS RR in Sekunden.

dwReserved

Reserviert. Nicht verwenden.

Data

Der DNS-RR-Datentyp wird durch wType- bestimmt und ist eines der folgenden Member:

SOA, Soa

Der RR-Datentyp ist DNS_SOA_DATA. Der Wert der wType- ist DNS_TYPE_SOA.

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

Der RR-Datentyp ist DNS_PTR_DATA. Der Wert von wType ist DNS_TYPE_PTR.

MINFO, Minfo, RP, Rp

Der RR-Datentyp ist DNS_MINFO_DATA. Der Wert wType- ist DNS_TYPE_MINFO.

MX, Mx, AFSDB, Afsdb, RT, Rt

Der RR-Datentyp ist DNS_MX_DATA. Der Wert wType- ist DNS_TYPE_MX.

HINFO, Hinfo, ISDN, Isdn, TXT, Txt, X25

Der RR-Datentyp ist DNS_TXT_DATA. Der Wert der wType- ist DNS_TYPE_TEXT.

WKS, Wks

Der RR-Datentyp ist DNS_WKS_DATA. Der Wert von wType- ist DNS_TYPE_WKS.

KEY, Schlüssel

Der RR-Datentyp ist DNS_KEY_DATA. Der Wert der wType- ist DNS_TYPE_KEY.

SIG, Sig

Der RR-Datentyp ist DNS_SIG_DATA. Der Wert wType- ist DNS_TYPE_SIG.

ATMA, Atma

Der RR-Datentyp ist DNS_ATMA_DATA. Der Wert der wType- ist DNS_TYPE_ATMA.

NXT, Nxt

Der RR-Datentyp ist DNS_NXT_DATA. Der Wert von wType- ist DNS_TYPE_NXT.

SRV, Srv

Der RR-Datentyp ist DNS_SRV_DATA. Der Wert wType- ist DNS_TYPE_SRV.

NAPTR, Naptr

Der RR-Datentyp ist DNS_NAPTR_DATA. Der Wert wType- ist DNS_TYPE_NAPTR.

OPT, Opt

Windows 7 oder höher: Der RR-Datentyp ist DNS_OPT_DATA. Der Wert der wType- ist DNS_TYPE_OPT.

DS, Ds

Windows 7 oder höher: Der RR-Datentyp ist DNS_DS_DATA. Der Wert wType- ist DNS_TYPE_DS.

RRSIG, Rrsig

Windows 7 oder höher: Der RR-Datentyp ist DNS_RRSIG_DATA. Der Wert wType- ist DNS_TYPE_RRSIG.

NSEC, Nsec

Windows 7 oder höher: Der RR-Datentyp ist DNS_NSEC_DATA. Der Wert wType- ist DNS_TYPE_NSEC.

DNSKEY, Dnskey

Windows 7 oder höher: Der RR-Datentyp ist DNS_DNSKEY_DATA. Der Wert von wType- ist DNS_TYPE_DNSKEY.

TKEY, Tkey

Der RR-Datentyp ist DNS_TKEY_DATA. Der Wert wType- ist DNS_TYPE_TKEY.

TSIG, Tsig

Der RR-Datentyp ist DNS_TSIG_DATA. Der Wert der wType- ist DNS_TYPE_TSIG.

WINS, Wins

Der RR-Datentyp ist DNS_WINS_DATA. Der Wert wType- ist DNS_TYPE_WINS.

WINSR, WinsR, NBSTAT, Nbstat

Der RR-Datentyp ist DNS_WINSR_DATA. Der Wert von wType- ist DNS_TYPE_WINSR.

Data.A

Der RR-Datentyp ist DNS_A_DATA. Der Wert von wType- ist 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

Der RR-Datentyp ist DNS_NULL_DATA. Der Wert von wType ist DNS_TYPE_NULL.

Data.WKS

Data.Wks

Data.AAAA

Der RR-Datentyp ist DNS_AAAA_DATA. Der Wert wType- ist 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 oder höher: Der RR-Datentyp ist DNS_DHCID_DATA. Der Wert wType- ist 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

Bemerkungen

Beim Erstellen einer DNS_RECORD Liste als Eingabeargument für die verschiedenen DNS-Updateroutinen in der DNS-API sollten alle Flags in der DNS_RECORD-Struktur auf Null festgelegt werden.

Anmerkung

Der windns.h-Header definiert DNS_RECORD als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Header- windns.h

Siehe auch

DNS_AAAA_DATA

DNS_ATMA_DATA

DNS_A_DATA

DNS_DHCID_DATA

DNS_DNSKEY_DATA

DNS_DS_DATA

DNS_KEY_DATA

DNS_LOC_DATA

DNS_MINFO_DATA

DNS_MX_DATA

DNS_NAPTR_DATA

DNS_NSEC_DATA

DNS_NULL_DATA

DNS_NXT_DATA

DNS_OPT_DATA

DNS_PTR_DATA

DNS_RRSIG_DATA

DNS_SIG_DATA

DNS_SOA_DATA

DNS_SRV_DATA

DNS_TKEY_DATA

DNS_TSIG_DATA

DNS_TXT_DATA

DNS_WINSR_DATA

DNS_WINS_DATA

DNS_WKS_DATA

DnsExtractRecordsFromMessage-

DnsModifyRecordsInSet-

DnsQuery-

DnsRecordCompare-

DnsRecordCopyEx-

DnsRecordSetCompare-

DnsRecordSetDetach-

DnsReplaceRecordSet-