CryptCATCDFOpen 函数 (mscat.h)
[ CryptCATCDFOpen 函数可用于“要求”部分中指定的操作系统。 在后续版本中,它可能已更改或不可用。]
CRYPTCATCDF 结构。 CryptCATCDFOpen 由 MakeCat 调用。
语法
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 条件 | 默认值 |
---|---|
未指定 Name 值。 | pwszFilePath 中的文件名用于目录 (.cat) 输出文件。 |
未指定 PublicVersion 值。 | 0x00000001 |
未指定 EncodingType 值。 | PKCS_7_ASN_ENCODING 或 X509_ASN_ENCODING (0x00010001) |
CryptCATCDFOpen 函数针对给定的错误条件执行以下操作。
添加状态 | 已执行的操作 |
---|---|
CDF 中找不到 CatalogHeader 或 Name 标记。 | 如果由调用方指定, CryptCATCDFOpen 函数将调用 pfnParseError 指定的函数并返回 NULL 指针。 |
CryptCATCDFOpen 函数调用 CryptCATOpen 函数以获取目录 (.cat) 输出文件的句柄,但它获得无效或 NULL 句柄。 | 调用 CryptCATCDFClose 函数并返回 NULL 指针。 |
目录分支的其他 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 |