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 函数。 有关操作系统提供的错误代码的完整列表，请参阅 系统错误代码。

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 mscat.h
Library Wintrust.lib
DLL Wintrust.dll

另请参阅

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog