Partager via


CryptCATPersistStore, fonction (mscat.h)

[La fonction CryptCATPersistStore est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

La fonction CryptCATPersistStore enregistre les informations dans le magasin de catalogues spécifié dans un fichier de catalogue non signé.

Syntaxe

BOOL CryptCATPersistStore(
  [in] HANDLE hCatalog
);

Paramètres

[in] hCatalog

Handle vers le catalogue obtenu à partir de la fonction CryptCATHandleFromStore ou CryptCATOpen . À compter de Windows 8, vous devez utiliser uniquement CryptCATOpen pour récupérer un handle.

Valeur retournée

La valeur de retour est TRUE si la fonction réussit ; sinon, FALSE.

Si cette fonction retourne FALSE, des informations d’erreur supplémentaires peuvent être obtenues en appelant la fonction GetLastError . GetLastError retourne le code d’erreur suivant.

Code de retour Descriptif
ERROR_INVALID_PARAMETER
Un ou plusieurs des paramètres ne sont pas valides.
ERROR_NOT_SUPPORTED
À compter de Windows 8 et Windows Server 2012, vous devez récupérer un handle en appelant la fonction CryptCATOpen avec le paramètre dwPublicVersion défini sur 0x100 ou 0x200. Pour plus d'informations, consultez la section Notes.

Remarques

La structure CRYPTCATSTORE doit être initialisée avant d’appeler CryptCATPersistStore.

À compter de Windows 8 et Windows Server 2012, les modifications suivantes s’appliquent à cette fonction :

  • Si CryptCATOpen a été appelé avec un paramètre dwPublicVersion de 0x200, le catalogue est écrit au format v2.
  • Si CryptCATOpen a été appelé avec un paramètre dwPublicVersion de 0x100, le catalogue est écrit au format v1.
  • Si CryptCATOpen a été appelé avec un paramètre dwPublicVersion autre que 0x200 ou 0x100, la fonction CryptCATPersistStore retourne FALSE et le code d’erreur est défini sur ERROR_NOT_SUPPORTED.

Spécifications

Requirement Valeur
Client minimum requis Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
plateforme cible Fenêtres
Header mscat.h
Library Wintrust.lib
DLL Wintrust.dll