DNS_TSIG_DATAW 構造体 (windns.h)

  • [アーティクル]

DNS_TSIG_DATA構造体は、RFC 2845 および RFC3645 で指定されている秘密キー トランザクション認証 (TSIG) リソース レコード (RR) を表します。

構文

typedef struct {
  PWSTR    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_DATAW, *PDNS_TSIG_DATAW;

メンバー

pNameAlgorithm

RFC 2845 のセクション 2.3 で定義されている pSignature の生成に使用されるキーの名前を表す文字列へのポインター。

pAlgorithmPacket

RFC 2845 のセクション 2.3 で定義されている pSignature の生成に使用されるアルゴリズムの名前を表す文字列へのポインター。

値 意味
"gss.microsoft.com"
 Windows 2000 サーバーのみ: RFC 3645 で定義されている DNS (GSS-API) の秘密鍵トランザクション認証の汎用セキュリティ サービス アルゴリズム。
"gss-tsig"
 RFC 3645 で定義されている DNS (GSS-API) の秘密鍵トランザクション認証の汎用セキュリティ サービス アルゴリズム。

pSignature

pAlgorithmPacket のアルゴリズムによって生成されたメッセージ認証コード (MAC) へのポインター。 pSignature の長さ、バイト単位、および構成は、pAlgorithmPacket によって決まります。

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 エントリを管理するために、DNS_RECORD構造と組み合わせて使用されます。

注意

windns.h ヘッダーは、DNS_TSIG_DATAをエイリアスとして定義します。このエイリアスは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header windns.h

こちらもご覧ください

DNS_RECORD

DNS_TKEY_DATA