Skip to content

Latest commit

 

History

History
111 lines (90 loc) · 3.85 KB

nf-mscat-cryptcatpersiststore.md

File metadata and controls

111 lines (90 loc) · 3.85 KB
Raw
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.
CryptCATPersistStore
CryptCATPersistStore function [Security]
mscat/CryptCATPersistStore
security.cryptcatpersiststore
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
CryptCATPersistStore
mscat/CryptCATPersistStore
c++
APIRef
kbSyntax
DllExport
Wintrust.dll
CryptCATPersistStore

CryptCATPersistStore function

-description

[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.

-parameters

-param hCatalog [in]

A handle to the catalog obtained from CryptCATHandleFromStore or CryptCATOpen function. Beginning with Windows 8 you must use only CryptCATOpen to retrieve a handle.

-returns

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
ERROR_INVALID_PARAMETER
 One or more of the parameters are not valid.
ERROR_NOT_SUPPORTED
 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.

-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.