SIP_SUBJECTINFO 構造体 (mssip.h)

  • [アーティクル]

SIP_SUBJECTINFO構造体は、サブジェクト インターフェイス パッケージ (SIP) API にサブジェクト情報データを指定します。

構文

typedef struct SIP_SUBJECTINFO_ {
  DWORD                      cbSize;
  GUID                       *pgSubjectType;
  HANDLE                     hFile;
  LPCWSTR                    pwsFileName;
  LPCWSTR                    pwsDisplayName;
  DWORD                      dwReserved1;
  DWORD                      dwIntVersion;
  HCRYPTPROV                 hProv;
  CRYPT_ALGORITHM_IDENTIFIER DigestAlgorithm;
  DWORD                      dwFlags;
  DWORD                      dwEncodingType;
  DWORD                      dwReserved2;
  DWORD                      fdwCAPISettings;
  DWORD                      fdwSecuritySettings;
  DWORD                      dwIndex;
  DWORD                      dwUnionChoice;
  union {
#if ...
    MS_ADDINFO_FLAT_                 *psFlat;
#else
    struct MS_ADDINFO_FLAT_          *psFlat;
#endif
#if ...
    MS_ADDINFO_CATALOGMEMBER_        *psCatMember;
#else
    struct MS_ADDINFO_CATALOGMEMBER_ *psCatMember;
#endif
#if ...
    MS_ADDINFO_BLOB_                 *psBlob;
#else
    struct MS_ADDINFO_BLOB_          *psBlob;
#endif
#if ...
    MS_ADDINFO_DETACHEDSIG_          *psDetachedSig;
#else
    struct MS_ADDINFO_DETACHEDSIG_   *psDetachedSig;
#endif
  };
  LPVOID                     pClientData;
} SIP_SUBJECTINFO, *LPSIP_SUBJECTINFO;

メンバー

cbSize

この構造体のサイズ (バイト単位)。

pgSubjectType

サブジェクトの種類を識別する GUID 構造体へのポインター。

hFile

件名を表すファイル ハンドル。 サブジェクトのストレージの種類がファイルの場合は、 hFile を INVALID_HANDLE_VALUE に設定し、 pwsFileName パラメーターをファイルの名前に設定します。

pwsFileName

サブジェクトのファイル名を含む null で終わる Unicode 文字列へのポインター。

pwsDisplayName

サブジェクトの表示名を含む null で終わる Unicode 文字列へのポインター。

dwReserved1

このメンバーは将来使用するために予約されています。

dwIntVersion

このメンバーは予約されています。 このメンバーは変更しないでください。 SIP は、get 関数と verify 関数の間で内部バージョン番号を渡すために使用されます。

hProv

暗号化プロバイダーに対する HCRYPTPROV ハンドル。

DigestAlgorithm

ファイル の ハッシュに使用される ハッシュ アルゴリズムの識別子を含むCRYPT_ALGORITHM_IDENTIFIER構造体。

dwFlags

この構造体を使用する関数の動作を変更する 値。 このメンバーで使用できる値の詳細については、SignerSignEx の dwFlags パラメーターを参照してください。

dwEncodingType

ファイルに使用されるエンコードの種類を指定する 値。 現在、 X509_ASN_ENCODING と PKCS_7_ASN_ENCODING のみが使用されています。ただし、今後、エンコードの種類が追加される可能性があります。 現在のエンコードの種類の場合は、 X509_ASN_ENCODING | PKCS_7_ASN_ENCODINGを使用します。

dwReserved2

このメンバーは将来使用するために予約されています。

fdwCAPISettings

このメンバーは使用されません。

fdwSecuritySettings

このメンバーは使用されません。

dwIndex

CryptSIPGetSignedDataMsg の最後の呼び出しのメッセージ インデックス。 操作を完了するための次の手順について引き続き調査中です。

dwUnionChoice

提供される追加情報の種類を指定します。

定義された定数/値 意味
MSSIP_ADDINFO_NONE
0
 件名に関する追加情報はありません。
MSSIP_ADDINFO_FLAT
1
 追加情報はフラット ファイルです。
MSSIP_ADDINFO_CATMEMBER
2
 追加情報はカタログ・メンバーです。
MSSIP_ADDINFO_BLOB
3
 追加情報は BLOB です。
MSSIP_ADDINFO_NONMSSIP
500
 追加情報は、ユーザー定義形式です。

psFlat

フラット ファイルのサブジェクトの種類に関する追加情報を含む MS_ADDINFO_FLAT 構造体。

psCatMember

カタログ ・メンバー ・サブジェクト・タイプの追加情報を含むMS_ADDINFO_CATALOGMEMBER構造体。

psBlob

BLOB サブジェクトの種類に関する追加情報を含む MS_ADDINFO_BLOB 構造体。

psDetachedSig

pClientData

SIP 固有のデータへのポインター。

注釈

SIP_SUBJECTINFO 構造体を最初に使用したら、構造体全体を 2 進ゼロに初期化します。 SIP 関数呼び出し間で構造体を初期化しないでください。

件名には、移植可能な実行可能イメージ (.exe)、キャビネット (.cab) イメージ、フラット ファイル、カタログ ファイルが含まれますが、これらに限定されません。 サブジェクトの種類ごとに、ハッシュ計算にデータの異なるサブセットが使用され、ストレージと取得には異なる手順が必要です。 したがって、各サブジェクトの種類には、一意のサブジェクト インターフェイス パッケージ仕様があります。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header mssip.h