Partager via

Fonction CryptCATPersistStore (mscat.h)

  • Article

[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 du magasin de catalogue spécifié dans un fichier catalogue non signé.

Syntaxe

BOOL CryptCATPersistStore(
  [in] HANDLE hCatalog
);

Paramètres

[in] hCatalog

Handle du 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 Description
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.

Notes

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.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mscat.h
Bibliothèque Wintrust.lib
DLL Wintrust.dll