struttura DNS_RECORDA (windnsdef.h)

La struttura DNS_RECORD archivia un record di risorse DNS (RR).

Sintassi

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;

Membri

pNext

Puntatore alla struttura DNS_RECORD successiva.

pName

Puntatore a una stringa che rappresenta il nome di dominio del set di record. Deve essere nel formato stringa che corrisponde alla funzione chiamata, ad esempio ANSI, Unicode o UTF8.

wType

Valore che rappresenta il tipo di record DNS RR. wType determina il formato di Data. Ad esempio, se il valore di wType è DNS_TYPE_A, il tipo di dati di Data è DNS_A_DATA.

wDataLength

Lunghezza, in byte, di Data. Per i tipi di dati a lunghezza fissa, questo valore corrisponde alla dimensione del tipo di dati corrispondente, ad esempio sizeof(DNS_A_DATA). Per i tipi di dati non fissi, utilizzare una delle macro seguenti per determinare la lunghezza dei dati:

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

Valore che contiene una bitmap di flag di record DNS .

Flags.S

Set di flag sotto forma di struttura DNS_RECORD_FLAGS.

dwTtl

Valore TTL (Time To Live) di DNS RR, espresso in secondi.

dwReserved

Riservato. Non usare.

Data

Il tipo di dati RR DNS è determinato da wType ed è uno dei membri seguenti:

SOA, Soa

Il tipo di dati RR è DNS_SOA_DATA. Il valore di wType è DNS_TYPE_SOA.

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

Il tipo di dati RR è DNS_PTR_DATA. Il valore di wType è DNS_TYPE_PTR.

MINFO, Minfo, RP, Rp

Il tipo di dati RR è DNS_MINFO_DATA. Il valore di wType è DNS_TYPE_MINFO.

MX, Mx, AFSDB, Afsdb, RT, Rt

Il tipo di dati RR è DNS_MX_DATA. Il valore di wType è DNS_TYPE_MX.

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

Il tipo di dati RR è DNS_TXT_DATA. Il valore di wType è DNS_TYPE_TEXT.

WKS, Wks

Il tipo di dati RR è DNS_WKS_DATA. Il valore di wType è DNS_TYPE_WKS.

KEY, Key

Il tipo di dati RR è DNS_KEY_DATA. Il valore di wType è DNS_TYPE_KEY.

SIG, Sig

Il tipo di dati RR è DNS_SIG_DATA. Il valore di wType è DNS_TYPE_SIG.

ATMA, Atma

Il tipo di dati RR è DNS_ATMA_DATA. Il valore di wType è DNS_TYPE_ATMA.

NXT, Nxt

Il tipo di dati RR è DNS_NXT_DATA. Il valore di wType è DNS_TYPE_NXT.

SRV, Srv

Il tipo di dati RR è DNS_SRV_DATA. Il valore di wType è DNS_TYPE_SRV.

NAPTR, Naptr

Il tipo di dati RR è DNS_NAPTR_DATA. Il valore di wType è DNS_TYPE_NAPTR.

OPT, Opt

Windows 7 o versione successiva: il tipo di dati RR è DNS_OPT_DATA. Il valore di wType è DNS_TYPE_OPT.

DS, Ds

Windows 7 o versione successiva: il tipo di dati RR è DNS_DS_DATA. Il valore di wType è DNS_TYPE_DS.

RRSIG, Rrsig

Windows 7 o versione successiva: il tipo di dati RR è DNS_RRSIG_DATA. Il valore di wType è DNS_TYPE_RRSIG.

NSEC, Nsec

Windows 7 o versione successiva: il tipo di dati RR è DNS_NSEC_DATA. Il valore di wType è DNS_TYPE_NSEC.

DNSKEY, Dnskey

Windows 7 o versione successiva: il tipo di dati RR è DNS_DNSKEY_DATA. Il valore di wType è DNS_TYPE_DNSKEY.

TKEY, Tkey

Il tipo di dati RR è DNS_TKEY_DATA. Il valore di wType è DNS_TYPE_TKEY.

TSIG, Tsig

Il tipo di dati RR è DNS_TSIG_DATA. Il valore di wType è DNS_TYPE_TSIG.

WINS, Wins

Il tipo di dati RR è DNS_WINS_DATA. Il valore di wType è DNS_TYPE_WINS.

WINSR, WinsR, NBSTAT, Nbstat

Il tipo di dati RR è DNS_WINSR_DATA. Il valore di wType è DNS_TYPE_WINSR.

Data.A

Il tipo di dati RR è DNS_A_DATA. Il valore di 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

Il tipo di dati RR è DNS_NULL_DATA. Il valore di wType è DNS_TYPE_NULL.

Data.WKS

Data.Wks

Data.AAAA

Il tipo di dati RR è DNS_AAAA_DATA. Il valore di 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 o versione successiva: il tipo di dati RR è DNS_DHCID_DATA. Il valore di 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

Osservazioni

Quando si compila un elenco di DNS_RECORD come argomento di input per le varie routine di aggiornamento DNS disponibili nell'API DNS, tutti i flag nella struttura DNS_RECORD devono essere impostati su zero.

Nota

L'intestazione windns.h definisce DNS_RECORD come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
intestazione	windnsdef.h

Vedere anche

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