[ CryptCATPersistStore 函数可用于“要求”部分中指定的作系统。 在后续版本中可能会更改或不可用。
CryptCATPersistStore 函数将指定目录存储中的信息保存到未签名的目录文件中。
Syntax
BOOL CryptCATPersistStore(
[in] HANDLE hCatalog
);
参数
[in] hCatalog
从 CryptCATHandleFromStore 或 CryptCATOpen 函数获取的目录的句柄。 从 Windows 8 开始,必须仅使用 CryptCATOpen 来检索句柄。
返回值
如果函数成功,则返回值为 TRUE ;否则为 FALSE。
如果此函数返回 FALSE,可以通过调用 GetLastError 函数获取其他错误信息。 GetLastError 将返回以下错误代码。
| 返回代码 | Description |
|---|---|
|
一个或多个参数无效。 |
|
从 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 |