使用 CryptCATAdminAddCatalog 安装目录文件

安装程序可以使用 CryptCATAdminAddCatalog 和其他 CryptCATAdminXxx 加密函数以编程方式在系统组件和驱动程序数据库中安装 目录文件 。

安装程序必须通过以下方式使用适用于 Windows 7 和 .NET Framework 4.0 的 Microsoft Windows 软件开发工具包 (SDK) ：

• 安装程序的源文件必须包含以下标头 (.h) 文件：

  • Mscat.h，用于定义各种 CryptCATAdminXxx 函数的原型和结构。
  • Softpub.h，定义 CryptCATAdminXxx 函数使用的各种数据结构和 GUID。

• 安装程序必须链接到 Wintrust.lib。

若要使用这些 CryptCATAdminXxx 加密函数，安装程序将执行以下操作：

1. 调用 CryptCATAdminAcquireContext 以获取目录管理员上下文的句柄。 应用程序通过将 pgSubsystem 输入参数设置为指向 GUID DRIVER_ACTION_VERIFY的指针来标识子系统。 此 GUID 在 Softpub.h 中定义。

2. 调用 CryptCATAdminAddCatalog 将 目录文件 添加到系统组件和驱动程序数据库。 安装程序提供步骤 1 中获取的目录管理员上下文的句柄、指向目录文件的完全限定路径的指针，以及指向函数用于在数据库中安装目录文件副本的目录文件的名称的指针。 函数返回已添加到数据库的目录文件的目录信息上下文的句柄。

3. 调用 CryptCATAdminReleaseCatalogContext 释放目录文件的目录信息上下文的句柄。 安装程序提供步骤 1 中获取的目录管理员上下文的句柄，以及步骤 2 中返回的目录信息上下文的句柄。

4. 调用 CryptCATAdminReleaseContext 以释放目录管理员上下文的句柄。 应用程序向步骤 1 中获取的目录管理员上下文提供句柄。