struttura DNS_RECORDA (windns.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;
Members
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 Dati. Ad esempio, se il valore di wType è DNS_TYPE_A, il tipo di dati di Data è DNS_A_DATA.
wDataLength
Lunghezza, in byte, di Dati. Per i tipi di dati a lunghezza fissa, questo valore è la 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> |
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) del 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
Commenti
Quando si compila un elenco di DNS_RECORD come argomento di input per le varie routine di aggiornamento DNS presenti 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Intestazione | windns.h |
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per