DNS_TSIG_DATAA結構（windns.h）

DNS_TSIG_DATA 結構代表如 RFC 2845 和 RFC 3645中所指定的秘密密鑰交易驗證 （TSIG） 資源記錄 。

語法

typedef struct {
  PSTR     pNameAlgorithm;
  PBYTE    pAlgorithmPacket;
  PBYTE    pSignature;
  PBYTE    pOtherData;
  LONGLONG i64CreateTime;
  WORD     wFudgeTime;
  WORD     wOriginalXid;
  WORD     wError;
  WORD     wSigLength;
  WORD     wOtherLength;
  UCHAR    cAlgNameLength;
  BOOL     bPacketPointers;
} DNS_TSIG_DATAA, *PDNS_TSIG_DATAA;

成員

pNameAlgorithm

字串的指標，表示用來產生 pSignature 的索引鍵名稱，如 RFC 2845一節中所定義。

pAlgorithmPacket

字串的指標，表示用來產生 pSignature 的演算法名稱，如 RFC 2845第 2.3 節所定義。

價值	意義
“gss.microsoft.com”	僅限 Windows 2000 Server：DNS 秘密密鑰交易驗證的泛型安全性服務演算法（GSS-API），如 RFC 3645中所定義。
“gss-tsig”	RFC 3645GSS-API中所定義的 DNS 秘密金鑰交易驗證一般安全性服務演算法。

pSignature

pAlgorithmPacket中演算法所產生的訊息驗證碼 （MAC） 指標。 pAlgorithmPacket決定 pSignature 的長度、位元組和組合。

pOtherData

如果 wError 包含 RCODE，BADTIME，pOtherData 是包含伺服器目前時間的 BYTE 陣列，否則會 NULL。 時間以秒為單位，從1970年1月1日開始，格林威治平均時間（GMT），不包括閏秒。

i64CreateTime

產生 pSignature 的時間，以秒為單位，從 1970 年 1 月 1 日起，格林威治標準時間 （GMT），不包括閏秒。

wFudgeTime

時間，以秒為單位，i64CreateTime 可能會發生錯誤。

wOriginalXid

原始訊息的 Xid 識別符。

wError

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

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

wSigLength

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

wOtherLength

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

cAlgNameLength

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

bPacketPointers

保留供日後使用。 請勿使用。

言論

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

注意

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

要求

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

另請參閱

DNS_RECORD

DNS_TKEY_DATA