DNS_DS_DATA structure (windns.h)

The DNS_DS_DATA structure represents a DS resource record (RR) as specified in section 2 of RFC 4034 and is used to verify the contents of DNS_DNSKEY_DATA.

Syntax

typedef struct {
  WORD wKeyTag;
  BYTE chAlgorithm;
  BYTE chDigestType;
  WORD wDigestLength;
  WORD wPad;
#if ...
  BYTE Digest[];
#else
  BYTE Digest[1];
#endif
} DNS_DS_DATA, *PDNS_DS_DATA;

Members

wKeyTag

A value that represents the method to choose which public key is used to verify Signature in DNS_RRSIG_DATA as specified in Appendix B of RFC 4034. This value is identical to the wKeyTag field in DNS_RRSIG_DATA.

chAlgorithm

A value that specifies the algorithm defined by DNS_DNSKEY_DATA. The possible values are shown in the following table.

Value Meaning
1
RSA/MD5 (RFC 2537)
2
Diffie-Hellman (RFC 2539)
3
DSA (RFC 2536)
4
Elliptic curve cryptography
5
RSA/SHA-1 (RFC 3110)

chDigestType

A value that specifies the cryptographic algorithm used to generate Digest. The possible values are shown in the following table.

Value Meaning
1
SHA-1 (RFC 3174)

wDigestLength

The length, in bytes. of the message digest in Digest. This value is determined by the algorithm type in chDigestType.

wPad

Reserved for padding. Do not use.

Digest

A BYTE array that contains a cryptographic digest of the DNSKEY RR and RDATA as specified in section 5.1.4 of RFC 4034. Its length is determined by wDigestLength.

Digest[1]

A BYTE array that contains a cryptographic digest of the DNSKEY RR and RDATA as specified in section 5.1.4 of RFC 4034. Its length is determined by wDigestLength.

Remarks

The DNS_DS_DATA structure is used in conjunction with the DNS_RECORD structure to programmatically manage DNS entries.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header windns.h

See also

DNS Structures

DNS_RECORD