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

另请参阅

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext