[ CryptCATCDFOpen 函数可用于“要求”部分中指定的作系统。 在后续版本中可能会更改或不可用。
CRYPTCATCDF 结构。 MakeCat 调用 CryptCATCDFOpen。
Syntax
CRYPTCATCDF * CryptCATCDFOpen(
[in] LPWSTR pwszFilePath,
[in, optional] PFN_CDF_PARSE_ERROR_CALLBACK pfnParseError
);
参数
[in] pwszFilePath
指向以 null 结尾的字符串的指针，其中包含要打开的 CDF 文件的路径。
[in, optional] pfnParseError
指向用于处理文件分析错误的用户定义的函数的指针。
返回值
成功后，此函数将返回指向新创建的 CRYPTCATCDF 结构的指针。 CryptCATCDFOpen 函数在失败时返回 NULL 指针。
注解
CryptCATCDFOpen 函数将以下默认值用于 CDF CatalogHeader 节中的给定条件。
| CatalogHeader 条件 | 默认值 |
|---|---|
| 未指定 名称 值。 | 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 指针。 |
| 目录分支的其他 OID | Definition |
|---|---|
| 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 不可用。
要求
| Requirement | 价值 |
|---|---|
| 最低支持的客户端 | Windows XP [仅限桌面应用] |
| 支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows操作系统 |
| Header | mscat.h |
| Library | nanosrv.lib |
| DLL | Wintrust.dll |