CertAddEncodedCertificateToSystemStoreW, fonction (wincrypt.h)

Article
11/20/2024

La fonction CertAddEncodedCertificateToSystemStore ouvre le magasin système spécifié et ajoute le certificat encodé à celui-ci.

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 de retour

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.

paramètre CertOpenSystemStore	Valeur
szSubsystemProtocol	szCertStoreName

Si CertAddEncodedCertificateToSystemStore obtient un handle dans le magasin système spécifié, il appelle CertCloseStore pour fermer le handle avant de retourner.

paramètre CertAddEncodedCertificateToStore	Valeur
dwCertEncodingType	X509_ASN_ENCODING
dwAddDisposition	CERT_STORE_ADD_USE_EXISTING
ppCertContext	NULL

Note

L’en-tête wincrypt.h définit CertAddEncodedCertificateToSystemStore comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wincrypt.h
bibliothèque	Crypt32.lib
DLL	Crypt32.dll

Partager via