Fonction CertSaveStore (wincrypt.h)
La fonction CertSaveStore enregistre le magasin de certificats dans un fichier ou dans un objet BLOB de mémoire.
Syntaxe
BOOL CertSaveStore(
[in] HCERTSTORE hCertStore,
[in] DWORD dwEncodingType,
[in] DWORD dwSaveAs,
[in] DWORD dwSaveTo,
[in, out] void *pvSaveToPara,
[in] DWORD dwFlags
);
Paramètres
[in] hCertStore
Handle du magasin de certificats à enregistrer.
[in] dwEncodingType
Spécifie le type d’encodage de certificat et le type d’encodage de message. L’encodage est utilisé uniquement lorsque dwSaveAs contient CERT_STORE_SAVE_AS_PKCS7. Sinon, le paramètre dwMsgAndCertEncodingType n’est pas utilisé.
Ce paramètre peut être une combinaison d’une ou plusieurs des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Spécifie l’encodage des messages PKCS 7. |
|
Spécifie l’encodage du certificat X.509. |
[in] dwSaveAs
Spécifie comment enregistrer le magasin de certificats.
Ce paramètre peut prendre les valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Le magasin de certificats peut être enregistré en tant que message signé PKCS #7 qui n’inclut pas de propriétés supplémentaires. Le paramètre dwEncodingType spécifie le type d’encodage du message. |
|
Le magasin de certificats peut être enregistré en tant que magasin sérialisé contenant des propriétés en plus des certificats encodés, des listes de révocation de certificats (CRL) et des listes de certificats d’approbation (CTL). Le paramètre dwEncodingType est ignoré.
Note La propriété CERT_KEY_CONTEXT_PROP_ID et les valeurs CERT_KEY_PROV_HANDLE_PROP_ID et CERT_KEY_SPEC_PROP_ID associées ne sont pas enregistrées dans un magasin sérialisé.
|
[in] dwSaveTo
Spécifie où et comment enregistrer le magasin de certificats. Le contenu de ce paramètre détermine le format du paramètre pvSaveToPara .
Ce paramètre peut prendre les valeurs suivantes.
| Valeur | Signification |
|---|---|
|
La fonction enregistre le magasin de certificats dans un fichier. Le paramètre pvSaveToPara contient un handle pour un fichier obtenu précédemment à l’aide de la fonction CreateFile . Le fichier doit être ouvert avec l’autorisation d’écriture. Après une opération d’enregistrement réussie, le pointeur de fichier est positionné après la dernière opération d’écriture. |
|
La fonction enregistre le magasin de certificats dans un fichier. Le paramètre pvSaveToPara contient un pointeur vers une chaîne Unicode terminée par null qui contient le chemin d’accès et le nom de fichier du fichier dans lequel enregistrer. La fonction ouvre le fichier, l’enregistre et le ferme. |
|
La fonction enregistre le magasin de certificats dans un fichier. Le paramètre pvSaveToPara contient un pointeur vers une chaîne ANSI terminée par null qui contient le chemin d’accès et le nom de fichier du fichier dans lequel enregistrer. La fonction ouvre le fichier, l’enregistre et le ferme. |
|
La fonction enregistre le magasin de certificats dans un fichier. Le paramètre pvSaveToPara contient un pointeur vers une chaîne Unicode terminée par null qui contient le chemin d’accès et le nom de fichier du fichier dans lequel enregistrer. La fonction ouvre le fichier, l’enregistre et le ferme. |
|
La fonction enregistre le magasin de certificats dans un objet BLOB mémoire. Le paramètre pvSaveToPara contient un pointeur vers une structure CERT_BLOB . Avant l’utilisation, les membres pbData et cbData du CERT_BLOB doivent être initialisés. Au retour, cbData est mis à jour avec la longueur réelle. Pour un calcul de longueur uniquement, pbData doit avoir la valeur NULL. Si pbData n’a pas la valeur NULL et que cbData n’est pas assez volumineux, la fonction retourne zéro avec un dernier code d’erreur de ERROR_MORE_DATA. |
[in, out] pvSaveToPara
Pointeur qui représente l’emplacement dans lequel le magasin doit être enregistré. Le contenu de ce paramètre dépend de la valeur du paramètre dwSaveTo .
[in] dwFlags
Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur zéro.
Valeur retournée
Si la fonction réussit, la fonction retourne une valeur différente de zéro.
Si la fonction échoue, elle retourne zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Notez que les erreurs CreateFile ou WriteFile peuvent être propagées à cette fonction. Un code d’erreur possible est CRYPT_E_FILE_ERROR qui indique qu’une erreur s’est produite lors de l’écriture dans le fichier.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | wincrypt.h |
| Bibliothèque | Crypt32.lib |
| DLL | Crypt32.dll |