Store.Load, méthode

Article
06/13/2023

[La méthode Load est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Utilisez plutôt la classe X509Store dans l’espace de noms System.Security.Cryptography.X509Certificates .]

La méthode Load importe les certificats d’un fichier dans le magasin.

Syntaxe

Store.Load( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal KeyStorageFlag ] _
)

Paramètres

FileName [in]

Chaîne qui contient le chemin d’accès à un fichier .cer, .sst, .spc, .p7s ou .pfx, ou tout fichier signé Authenticode.

Mot de passe [in, facultatif]

Chaîne qui contient le mot de passe en texte clair du fichier. Jusqu’à 32 caractères Unicode, y compris un caractère null de fin, peuvent être utilisés pour le mot de passe. Pour plus d’informations sur la protection du mot de passe, consultez Gestion des mots de passe.

KeyStorageFlag [in, facultatif]

Valeur de l’énumération CAPICOM_KEY_STORAGE_FLAG qui définit les indicateurs de stockage de clés. La valeur par défaut est CAPICOM_KEY_STORAGE_DEFAULT. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
CAPICOM_KEY_STORAGE_DEFAULT	Stockage de clé par défaut.
CAPICOM_KEY_STORAGE_EXPORTABLE	La clé est exportable.
CAPICOM_KEY_STORAGE_USER_PROTECTED	La clé est protégée par l’utilisateur.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

Si la méthode Load est appelée sur un magasin de mémoire, tous les conteneurs de clés créés sont supprimés lorsque le magasin de mémoire est supprimé. Par exemple, si un fichier .pfx est chargé dans un magasin de mémoire et ajouté ultérieurement à un magasin système (tel que Mon magasin) à partir du magasin de mémoire, le certificat dans le magasin Mon ne contiendra pas de clé. Dans ce cas, le fichier .pfx doit être chargé directement dans mon magasin.

Cette méthode déclenche CAPICOM_E_NOT_ALLOWED lorsqu’elle est scriptée à partir d’une application web.

Si le mot de passe ne parvient pas à déchiffrer le fichier de clé privée, le fournisseur de services de chiffrement (CSP) par défaut doit être interrogé. Si le fournisseur de services de chiffrement par défaut est le fournisseur de chiffrement de base Microsoft et que l’opération de déchiffrement échoue, l’opération de déchiffrement doit être réessayée avec le fournisseur de chiffrement microsoft fort ou le fournisseur de chiffrement microsoft amélioré, selon la disponibilité.

Si le certificat en cours de chargement dans le magasin est le même que celui qui existe déjà, la méthode Load supprime le certificat existant du magasin, puis ajoute le nouveau certificat. Le nouveau certificat héritera des propriétés du certificat existant. Le conteneur de clé privée existant est remplacé par le nouveau conteneur de clé privée.

Spécifications

Condition requise	Valeur
Composant redistribuable	CAPICOM 2.0 ou version ultérieure sur Windows Server 2003 et Windows XP
DLL	Capicom.dll

Voir aussi

Magasin

Partager via