CryptCATCDFOpen 関数 (mscat.h)
[ CryptCATCDFOpen 関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。
CRYPTCATCDF 構造体。 CryptCATCDFOpen は MakeCat によって呼び出されます。
構文
CRYPTCATCDF * CryptCATCDFOpen(
[in] LPWSTR pwszFilePath,
[in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);
パラメーター
[in] pwszFilePath
開く CDF ファイルのパスを含む null で終わる文字列へのポインター。
[in, optional] pfnParseError
ファイル解析エラーを処理するユーザー定義関数へのポインター。
戻り値
成功すると、この関数は新しく作成された CRYPTCATCDF 構造体へのポインターを返します。 CryptCATCDFOpen 関数は、失敗した場合に NULL ポインターを返します。
注釈
次の既定値は、CDF CatalogHeader セクションの特定の条件に対して CryptCATCDFOpen 関数によって使用されます。
| CatalogHeader 条件 | 既定値 |
|---|---|
| Name 値は指定されません。 | pwszFilePath のファイル名は、カタログ (.cat) 出力ファイルに使用されます。 |
| PublicVersion 値は指定されません。 | 0x00000001 |
| EncodingType 値が指定されません。 | PKCS_7_ASN_ENCODING または X509_ASN_ENCODING (0x00010001) |
次のアクションは、指定されたエラー条件に対して CryptCATCDFOpen 関数によって実行されます。
| エラー状態 | 実行されたアクション |
|---|---|
| CDF に CatalogHeader タグまたは 名前 タグが見つかりません。 | 呼び出し元によって指定された場合、 CryptCATCDFOpen 関数は pfnParseError で指定された関数を呼び出し、 NULL ポインターを返します。 |
| CryptCATCDFOpen 関数は CryptCATOpen 関数を呼び出してカタログ (.cat) 出力ファイルへのハンドルを取得しますが、無効または NULL ハンドルを取得します。 | CryptCATCDFClose 関数を呼び出し、NULL ポインターを返します。 |
| Catalog ブランチの追加 OID | 定義 |
|---|---|
| szOID_CATALOG_LIST_MEMBER_V2 | 1.3.6.1.4.1.311.12.1.3 |
| CAT_MEMBERINFO2_OBJID | 1.3.6.1.4.1.311.12.2.3 |
Windows Server 2008 R2、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: 追加のカタログ OID は使用できません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | mscat.h |
| [DLL] | Wintrust.dll |