CryptCATAdminAddCatalog 函数 (mscat.h)
[ CryptCATAdminAddCatalog 函数可用于“要求”部分中指定的操作系统。 在后续版本中，它可能已更改或不可用。]
CryptCATAdminAddCatalog 函数将目录添加到目录数据库。 目录数据库是一个索引，用于将文件哈希与包含它们的目录相关联。 它用于在验证文件签名时加快目录的识别速度。 此函数是以编程方式将目录添加到 Windows 目录数据库的唯一受支持方法。 函数没有关联的导入库。 必须使用 LoadLibrary 和 GetProcAddress 函数动态链接到 Wintrust.dll。
语法
HCATINFO CryptCATAdminAddCatalog(
[in] HCATADMIN hCatAdmin,
[in] PWSTR pwszCatalogFile,
[in] PWSTR pwszSelectBaseName,
[in] DWORD dwFlags
);
参数
[in] hCatAdmin
以前由 CryptCATAdminAcquireContext 函数分配的句柄。
[in] pwszCatalogFile
指向要添加的目录的完全限定路径的 以 null 结尾的字符串的指针。
[in] pwszSelectBaseName
指向以 null 结尾的字符串的指针，表示存储目录时该目录的名称。 如果 参数为 NULL，则将为目录生成唯一名称。
[in] dwFlags
如果指定了CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001) 标志，则调用中指定的目录将硬链接而不是复制。 硬链接而不是复制目录可以减少 Windows 所需的磁盘空间量。
返回值
如果函数成功，则返回值是目录信息上下文的句柄。 如果函数失败，则返回值为 NULL。 使用完返回的句柄后，通过调用 CryptCATAdminReleaseCatalogContext 函数来释放它。
对于扩展的错误信息，请调用 GetLastError 函数。 有关操作系统提供的错误代码的完整列表，请参阅 系统错误代码。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mscat.h |
| Library | Wintrust.lib |
| DLL | Wintrust.dll |