DNS_TKEY_DATAA結構（windns.h）

DNS_TKEY_DATA 結構代表 DNS TKEY 資源記錄，用來建立和刪除 DNS 解析程式與伺服器之間的演算法共用秘密密鑰，如 RFC 2930 中所指定。

語法

typedef struct {
  PSTR  pNameAlgorithm;
  PBYTE pAlgorithmPacket;
  PBYTE pKey;
  PBYTE pOtherData;
  DWORD dwCreateTime;
  DWORD dwExpireTime;
  WORD  wMode;
  WORD  wError;
  WORD  wKeyLength;
  WORD  wOtherLength;
  UCHAR cAlgNameLength;
  BOOL  bPacketPointers;
} DNS_TKEY_DATAA, *PDNS_TKEY_DATAA;

成員

pNameAlgorithm

字串的指標，表示如 RFC 2930第 2.1 節中所定義的索引鍵名稱。

pAlgorithmPacket

字串的指標，表示定義於 RFC 2930第 2.3 節中所定義的演算法名稱。 pKey 是用來衍生演算法特定密鑰。

pKey

可變長度共用秘密密鑰的指標。

pOtherData

保留。 請勿使用。

dwCreateTime

密鑰的建立日期和時間，以 1970 年 1 月 1 日起的秒數表示，格林威治平均時間 （GMT），不包括閏秒。

dwExpireTime

密鑰的到期日，以秒為單位，從1970年1月1日開始，格林威治平均時間（GMT），不包括閏秒。

wMode

用於金鑰協定或 TKEY DNS 訊息用途的配置。 下列列出 wMode 的可能值：

價值	意義
DNS_TKEY_MODE_SERVER_ASSIGN	金鑰是由 DNS 伺服器指派，不會交涉。
DNS_TKEY_MODE_DIFFIE_HELLMAN	Diffie-Hellman 金鑰交換演演算法可用來交涉金鑰。
DNS_TKEY_MODE_GSS	密鑰是透過泛型安全性 Services-Application 程式介面（GSS-API）交涉來交換。
DNS_TKEY_MODE_RESOLVER_ASSIGN	密鑰是由 DNS 解析程式指派，不會交涉。

wError

以涵蓋 TSIG 和 TKEY RR 處理的擴充 RCODE 格式表示的錯誤。

價值	意義
DNS_RCODE_BADSIG	DNS_TSIG_DATA RR 的 pSignature 不正確。
DNS_RCODE_BADKEY	pKey 欄位不正確。
DNS_RCODE_BADTIME	時間戳不正確。

wKeyLength

pKey 成員的長度，以位元組為單位。

wOtherLength

pOtherData 成員的長度，以位元組為單位。

cAlgNameLength

pNameAlgorithm 成員的長度，以位元組為單位。

bPacketPointers

保留。 請勿使用。

言論

DNS_TKEY_DATA 結構會與 DNS_RECORD 結構搭配使用，以程式設計方式管理 DNS 專案。

注意

windns.h 標頭會將 DNS_TKEY_DATA定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	windns.h

另請參閱

DNS_RECORD

DNS_TSIG_DATA