Fonction CertAddEncodedCertificateToSystemStoreW (wincrypt.h)

Article
08/27/2023

La fonction CertAddEncodedCertificateToSystemStore ouvre le magasin système spécifié et y ajoute le certificat codé.

Syntaxe

BOOL CertAddEncodedCertificateToSystemStoreW(
  [in] LPCWSTR    szCertStoreName,
  [in] const BYTE *pbCertEncoded,
  [in] DWORD      cbCertEncoded
);

Paramètres

[in] szCertStoreName

Chaîne terminée par null qui contient le nom du magasin système pour le certificat encodé.

[in] pbCertEncoded

Pointeur vers une mémoire tampon qui contient le certificat encodé à ajouter.

[in] cbCertEncoded

Taille, en octets, de la mémoire tampon pbCertEncoded .

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE.

Si la fonction échoue, la valeur de retour est FALSE. CertAddEncodedCertificateToSystemStore dépend des fonctions répertoriées dans les remarques suivantes pour la gestion des erreurs. Reportez-vous à ces rubriques de fonction pour connaître leurs comportements respectifs de gestion des erreurs. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

En interne, CertAddEncodedCertificateToSystemStore appelle CertOpenSystemStore et CertAddEncodedCertificateToStore avec les paramètres suivants.

CertOpenSystemStore Paramètre	Valeur
szSubsystemProtocol	szCertStoreName

Si CertAddEncodedCertificateToSystemStore obtient un handle pour le magasin système spécifié, il appelle CertCloseStore pour fermer le handle avant qu’il ne retourne.

CertAddEncodedCertificateToStore Paramètre	Valeur
dwCertEncodingType	X509_ASN_ENCODING
dwAddDisposition	CERT_STORE_ADD_USE_EXISTING
ppCertContext	NULL

Notes

L’en-tête wincrypt.h définit CertAddEncodedCertificateToSystemStore en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
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	wincrypt.h
Bibliothèque	Crypt32.lib
DLL	Crypt32.dll

Partager via