CryptCATAdminAcquireContext 函数 (mscat.h)

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

CryptCATAdminAcquireContext 函数获取目录管理员上下文的句柄。此句柄可由后续调用 CryptCATAdminAddCatalog、 CryptCATAdminEnumCatalogFromHash 和 CryptCATAdminRemoveCatalog 函数使用。此函数没有关联的导入库。必须使用 LoadLibrary 和 GetProcAddress 函数动态链接到 Wintrust.dll。

语法

BOOL CryptCATAdminAcquireContext(
  [out] HCATADMIN  *phCatAdmin,
  [in]  const GUID *pgSubsystem,
  [in]  DWORD      dwFlags
);

[out] phCatAdmin

指向此函数分配的目录管理员上下文句柄的指针。使用完句柄后，通过调用 CryptCATAdminReleaseContext 函数将其关闭。

[in] pgSubsystem

指向标识子系统的 GUID 的指针。 DRIVER_ACTION_VERIFY表示操作系统组件和第三方驱动程序的子系统。这是大多数实现使用的子系统。

[in] dwFlags

未使用;设置为零。

如果函数成功，则返回值为 TRUE ;如果函数失败，则 为 FALSE 。

对于扩展的错误信息，请调用 GetLastError 函数。有关操作系统提供的错误代码的完整列表，请参阅系统错误代码。