UID | title | description | helpviewer_keywords | old-location | tech.root | ms.assetid | ms.date | ms.keywords | req.header | req.include-header | req.target-type | req.target-min-winverclnt | req.target-min-winversvr | req.kmdf-ver | req.umdf-ver | req.ddi-compliance | req.unicode-ansi | req.idl | req.max-support | req.namespace | req.assembly | req.type-library | req.lib | req.dll | req.irql | targetos | req.typenames | req.redist | ms.custom | f1_keywords | dev_langs | topic_type | api_type | api_location | api_name | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
NF:mscat.CryptCATPersistStore |
CryptCATPersistStore function (mscat.h) |
Saves the information in the specified catalog store to an unsigned catalog file. |
|
security\cryptcatpersiststore.htm |
security |
2a564b0e-fcc6-4702-8173-d18df7064e53 |
12/05/2018 |
CryptCATPersistStore, CryptCATPersistStore function [Security], mscat/CryptCATPersistStore, security.cryptcatpersiststore |
mscat.h |
Windows |
Windows XP [desktop apps only] |
Windows Server 2003 [desktop apps only] |
Wintrust.lib |
Wintrust.dll |
Windows |
19H1 |
|
|
|
|
|
|
[The CryptCATPersistStore function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]
The CryptCATPersistStore function saves the information in the specified catalog store to an unsigned catalog file.
A handle to the catalog obtained from CryptCATHandleFromStore or CryptCATOpen function. Beginning with Windows 8 you must use only CryptCATOpen to retrieve a handle.
The return value is TRUE if the function succeeds; otherwise, FALSE.
If this function returns FALSE, additional error information can be obtained by calling the GetLastError function. GetLastError will return the following error code.
Return code | Description |
---|---|
|
One or more of the parameters are not valid. |
|
Beginning with Windows 8 and Windows Server 2012, you must retrieve a handle by calling the CryptCATOpen function with the dwPublicVersion parameter set to 0x100 or 0x200. For more information, see Remarks. |
The CRYPTCATSTORE structure must be initialized before you call CryptCATPersistStore.
Beginning with Windows 8 and Windows Server 2012, the following changes apply to this function:
- If CryptCATOpen was called with a dwPublicVersion parameter of 0x200, the catalog is written by using the v2 format.
- If CryptCATOpen was called with a dwPublicVersion parameter of 0x100, the catalog is written by using the v1 format.
- If CryptCATOpen was called with a dwPublicVersion parameter other than 0x200 or 0x100, the CryptCATPersistStore function returns FALSE and the error code is set to ERROR_NOT_SUPPORTED.