CertAddCTLContextToStore, fonction (wincrypt.h)

Article
08/27/2023

La fonction CertAddCTLContextToStore ajoute un contexte de liste de certificats d’approbation (CTL) à un magasin de certificats.

Syntaxe

BOOL CertAddCTLContextToStore(
  [in]            HCERTSTORE    hCertStore,
  [in]            PCCTL_CONTEXT pCtlContext,
  [in]            DWORD         dwAddDisposition,
  [out, optional] PCCTL_CONTEXT *ppStoreContext
);

Paramètres

[in] hCertStore

Handle d’un magasin de certificats.

[in] pCtlContext

Pointeur vers la structure CTL_CONTEXT à ajouter au magasin.

[in] dwAddDisposition

Spécifie l’action à entreprendre si une CTL correspondante ou un lien vers une CTL correspondante existe déjà dans le magasin. Les valeurs de disposition actuellement définies et leurs utilisations sont les suivantes.

Valeur	Signification
CERT_STORE_ADD_ALWAYS	N’effectue aucune case activée pour une CTL correspondante existante ou un lien vers une CTL correspondante. Une nouvelle CTL est toujours ajoutée au magasin. Cela peut entraîner des doublons dans un magasin.
CERT_STORE_ADD_NEW	S’il existe une CTL correspondante ou un lien vers une CTL correspondante, l’opération échoue. GetLastError retourne le code CRYPT_E_EXISTS.
CERT_STORE_ADD_NEWER	S’il existe une CTL correspondante ou un lien vers une CTL correspondante, les heures ThisUpdate sur les CTL sont comparées. Si la CTL existante a une durée ThisUpdate inférieure à la durée ThisUpdate sur la nouvelle CTL, l’ancienne CTL ou le lien est remplacé comme avec CERT_STORE_ADD_REPLACE_EXISTING. Si la CTL existante a une durée ThisUpdate supérieure ou égale à l’heure ThisUpdate sur la CTL à ajouter, la fonction échoue avec GetLastError qui retourne le code CRYPT_E_EXISTS. Si une CTL correspondante ou un lien vers une CTL correspondante est introuvable dans le magasin, une nouvelle CTL est ajoutée au magasin.
CERT_STORE_ADD_NEWER_INHERIT_PROPERTIES	L’action est la même que pour CERT_STORE_ADD_NEWER, sauf que si une ancienne CTL est remplacée, les propriétés de l’ancienne CTL sont incorporées dans la CTL de remplacement.
CERT_STORE_ADD_REPLACE_EXISTING	S’il existe une CTL correspondante ou un lien vers une CTL correspondante, la CTL ou le lien existant est supprimé et une nouvelle CTL est créée et ajoutée au magasin. Si une CTL correspondante ou un lien vers une CTL correspondante n’existe pas, il en est ajouté une.
CERT_STORE_ADD_REPLACE_EXISTING_INHERIT_PROPERTIES	S’il existe une CTL correspondante dans le magasin, ce contexte existant est supprimé avant de créer et d’ajouter le nouveau contexte. Le contexte ajouté hérite des propriétés de la CTL existante.
CERT_STORE_ADD_USE_EXISTING	S’il existe une CTL correspondante ou un lien vers une CTL correspondante, cette CTL existante est utilisée et les propriétés de la nouvelle CTL sont ajoutées. La fonction n’échoue pas, mais aucune nouvelle CTL n’est ajoutée. Si ppCertContext n’est pas NULL, le contexte existant est dupliqué. Si une CTL correspondante ou un lien vers une CTL correspondante n’existe pas, une nouvelle CTL est ajoutée.

[out, optional] ppStoreContext

Pointeur vers un pointeur vers le contexte CTL décodé. Ce paramètre facultatif peut être NULL , ce qui indique que l’application appelante n’a pas besoin d’une copie de la CTL ajoutée ou existante. Si une copie est effectuée, ce contexte doit être libéré à l’aide de CertFreeCTLContext.

Valeur retournée

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

Si la fonction échoue, la valeur de retour est FALSE. Les erreurs des fonctions appelées CertAddEncodedCRLToStore et CertSetCRLContextProperty peuvent être propagées à cette fonction.

Pour obtenir des informations d’erreur étendues, appelez GetLastError. Certains codes d’erreur possibles suivent.

Code de retour	Description
CRYPT_E_EXISTS	Cette erreur est retournée si CERT_STORE_ADD_NEW est défini et que la CTL existe dans le magasin ou si CERT_STORE_ADD_NEWER est défini et qu’une CTL existe dans le magasin avec une date ThisUpdate supérieure ou égale à la date ThisUpdate sur la CTL à ajouter.
E_INVALIDARG	Une disposition d’ajout non valide a été spécifiée par le paramètre dwAddDisposition .

Remarques

Le contexte CTL n’est pas dupliqué à l’aide de CertDuplicateCTLContext. Au lieu de cela, une nouvelle copie est créée et ajoutée au magasin. En plus de la CTL encodée, les propriétés du contexte sont copiées.

Pour supprimer le contexte CTL du magasin de certificats, utilisez la fonction CertDeleteCTLFromStore .

Configuration requise

Condition requise	Valeur
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

Voir aussi

CertAddEncodedCTLToStore

CertSetCTLContextProperty

Fonctions de liste d’approbation de certificats