Edit

Share via

DNS_KEY_DATA structure (windns.h)

  • Article

The DNS_KEY_DATA structure represents a DNS key (KEY) resource record (RR) as specified in RFC 3445.

Syntax

typedef struct {
  WORD wFlags;
  BYTE chProtocol;
  BYTE chAlgorithm;
  WORD wKeyLength;
  WORD wPad;
#if ...
  BYTE Key[];
#else
  BYTE Key[1];
#endif
} DNS_KEY_DATA, *PDNS_KEY_DATA, DNS_DNSKEY_DATA, *PDNS_DNSKEY_DATA;

Members

wFlags

A set of flags that specify whether this is a zone key as described in section 4 of RFC 3445.

chProtocol

A value that specifies the protocol with which Key can be used. The possible values are shown in the following table.

Value Meaning
3
 Domain Name System Security Extensions (DNSSEC)

chAlgorithm

A value that specifies the algorithm to use with Key. 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). DNS_DNSKEY_DATA only.

wKeyLength

The length, in bytes, of Key. This value is determined by the algorithm type in chAlgorithm.

wPad

Reserved. Do not use.

Key

A BYTE array that contains the public key for the algorithm in chAlgorithm, represented in base 64, as described in Appendix A of RFC 2535.

Key[1]

A BYTE array that contains the public key for the algorithm in chAlgorithm, represented in base 64, as described in Appendix A of RFC 2535.

Remarks

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

The DNS_DNSKEY_DATA structure represents a DNSKEY resource record as specified in section 2 of RFC 4034.

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

The value of the wFlags member for DNS_DNSKEY_DATA is a set of flags that specify key properties as described in section 2.1.1 of RFC 4034.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header windns.h

See also

DNS_RECORD