CryptCATPersistStore 函数 (mscat.h)

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

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

语法

BOOL CryptCATPersistStore(
  [in] HANDLE hCatalog
);

[in] hCatalog

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

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

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

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

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

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

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