CryptCATPersistStore 函数 (mscat.h)

[ CryptCATPersistStore 函数可用于“要求”部分中指定的作系统。 在后续版本中可能会更改或不可用。

CryptCATPersistStore 函数将指定目录存储中的信息保存到未签名的目录文件中。

Syntax

BOOL CryptCATPersistStore(
  [in] HANDLE hCatalog
);

参数

[in] hCatalog

CryptCATHandleFromStoreCryptCATOpen 函数获取的目录的句柄。 从 Windows 8 开始,必须仅使用 CryptCATOpen 来检索句柄。

返回值

如果函数成功,则返回值为 TRUE ;否则为 FALSE

如果此函数返回 FALSE,可以通过调用 GetLastError 函数获取其他错误信息。 GetLastError 将返回以下错误代码。

返回代码 Description
ERROR_INVALID_PARAMETER
一个或多个参数无效。
ERROR_NOT_SUPPORTED
从 Windows 8 和 Windows Server 2012 开始,必须通过调用 dwPublicVersion 参数设置为0x100或0x200的 CryptCATOpen 函数来检索句柄。 有关详细信息,请参阅“备注”。

注解

调用 CryptCATPersistStore 之前,必须先初始化 CRYPTCATSTORE 结构。

从 Windows 8 和 Windows Server 2012 开始,以下更改适用于此函数:

  • 如果使用 dwPublicVersion 参数0x200调用 CryptCATOpen,则目录是使用 v2 格式编写的。
  • 如果使用 dwPublicVersion 参数0x100调用 CryptCATOpen,则目录是使用 v1 格式编写的。
  • 如果使用除 0x200 或 0x100 以外的 dwPublicVersion 参数调用 CryptCATOpen,CryptCATPersistStore 函数将返回 FALSE,错误代码设置为ERROR_NOT_SUPPORTED

要求

Requirement 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows操作系统
Header mscat.h
Library Wintrust.lib
DLL Wintrust.dll