ICertificate2::Save, méthode

[CAPICOM est un composant 32 bits uniquement disponible pour une utilisation dans les systèmes d’exploitation suivants : Windows Server 2008, Windows Vista et Windows XP. Utilisez plutôt la classe X509Certificate2 dans l’espace de noms System.Security.Cryptography.X509Certificates .]

La méthode Save enregistre le certificat dans un fichier. Cette méthode a été introduite dans CAPICOM 2.0.

Syntaxe

Certificate.Save( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal SaveAs ], _
  [ ByVal IncludeOption ] _
)

Paramètres

FileName [in]

Chaîne qui contient le nom du fichier de sortie dans lequel le certificat sera enregistré.

Mot de passe [in, facultatif]

Chaîne qui contient le mot de passe en texte clair d’un fichier de clé privée . Le mot de passe peut contenir jusqu’à 32 caractères Unicode, y compris un caractère null de fin. Pour plus d’informations sur la protection du mot de passe, consultez Gestion des mots de passe.

SaveAs [in, facultatif]

Valeur de l’énumération CAPICOM_CERTIFICATE_SAVE_AS_TYPE qui spécifie le format du fichier de sortie. La valeur par défaut est CAPICOM_CERTIFICATE_SAVE_AS_CER. Le tableau suivant répertorie les valeurs possibles.

Value	Signification
CAPICOM_CERTIFICATE_SAVE_AS_CER	Le fichier de sortie est formaté en tant que fichier .cer sans clé privée enregistrée.
CAPICOM_CERTIFICATE_SAVE_AS_PFX	Le fichier de sortie sera au format .pfx (PKCS #12) et toutes les clés privées associées exportables seront également enregistrées.

 

IncludeOption [in, facultatif]

Valeur de l’énumération CAPICOM_CERTIFICATE_INCLUDE_OPTION qui spécifie le nombre de certificats enregistrés dans la chaîne dans le fichier de sortie. La valeur par défaut est CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY. Le tableau suivant répertorie les valeurs possibles.

Value	Signification
CAPICOM_CERTIFICATE_INCLUDE_CHAIN_EXCEPT_ROOT	Enregistre tous les certificats de la chaîne à l’exception de l’entité racine
CAPICOM_CERTIFICATE_INCLUDE_WHOLE_CHAIN	Enregistre la chaîne de certificats complète
CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY	Enregistre uniquement le certificat d’entité de fin

 

Valeur retournée

Cette méthode ne retourne pas de valeur.

Notes

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

Spécifications