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
提供される追加情報の種類を指定します。
定義された定数/値 | 意味 |
---|---|
|
件名に関する追加情報はありません。 |
|
追加情報はフラット ファイルです。 |
|
追加情報はカタログ・メンバーです。 |
|
追加情報は BLOB です。 |
|
追加情報は、ユーザー定義形式です。 |
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 |