CryptCATCDFOpen 函数 (mscat.h)

[ CryptCATCDFOpen 函数可用于“要求”部分中指定的操作系统。 在后续版本中,它可能已更改或不可用。]

CRYPTCATCDF 结构。 CryptCATCDFOpenMakeCat 调用。

语法

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_ENCODINGX509_ASN_ENCODING (0x00010001)
 

CryptCATCDFOpen 函数针对给定的错误条件执行以下操作。

添加状态 已执行的操作
CDF 中找不到 CatalogHeaderName 标记。 如果由调用方指定, 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

另请参阅

CRYPTCATCDF

CryptCATCDFClose

CryptCATOpen

MakeCat