Objet Certificate
[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 .]
L’objet Certificate représente un seul certificat numérique.
L’objet Certificate expose les interfaces suivantes :
- ICertificate : introduit dans CAPICOM 1.0.
- ICertificate2 — Introduit dans CAPICOM 2.0.
Quand l’utiliser
L’objet Certificate est utilisé pour effectuer les tâches suivantes :
- Chargez les données de certificat, y compris la clé privée, à partir d’un fichier.
- Obtenez des informations à partir du certificat.
- Retourne les contraintes de base, la référence EKU, les propriétés étendues, les extensions, l’utilisation des clés, la clé publique et les objets de modèle associés au certificat.
- Déterminez si le certificat est valide et case activée la disponibilité de l’accès de la clé privée du sujet du certificat.
- Affichez le certificat.
- Importez et exportez le certificat.
- Enregistrez le certificat dans un fichier.
- Récupérez ou définissez les propriétés qui décrivent le certificat.
Membres
L’objet Certificate a les types de membres suivants :
Méthodes
L’objet Certificate possède ces méthodes.
| Méthode | Description |
|---|---|
| BasicConstraints | Retourne un objet BasicConstraints qui représente l’extension des contraintes de base du certificat. (Hérité de CertificateICertificate2ICertificate) |
| Affichage | Affiche un certificat. (Hérité de CertificateICertificate2ICertificate) |
| Exporter | Copie un certificat dans une chaîne encodée. La chaîne encodée peut être écrite dans un fichier ou importée dans un nouvel objet Certificate . (Hérité de CertificateICertificate2ICertificate) |
| ExtendedKeyUsage | Renvoie un objet ExtendedKeyUsage qui indique les utilisations valides de la clé étendue du certificat. (Hérité de CertificateICertificate2ICertificate) |
| ExtendedProperties | Retourne une collection des propriétés étendues du certificat. (Hérité de CertificateICertificate2) |
| Extensions | Retourne une collection des extensions associées au certificat. (Hérité de CertificateICertificate2) |
| GetInfo | Récupère les informations du certificat. (Hérité de CertificateICertificate2ICertificate) |
| HasPrivateKey | Détermine si une clé privée est associée au certificat. (Hérité de CertificateICertificate2ICertificate) |
| Importer | Importe un certificat précédemment encodé à partir d’une chaîne dans l’objet Certificate . (Hérité de CertificateICertificate2ICertificate) |
| IsValid | Génère une chaîne de vérification de certificat pour un certificat et retourne un objet CertificateStatus qui contient la validité status du certificat. (Hérité de CertificateICertificate2ICertificate) |
| KeyUsage | Retourne un objet KeyUsage qui indique l’utilisation valide de la clé du certificat. (Hérité de CertificateICertificate2ICertificate) |
| Charge | Importe un certificat à partir d’un fichier. (Hérité de CertificateICertificate2) |
| Publickey | Renvoie un objet PublicKey . (Hérité de CertificateICertificate2) |
| Enregistrer | Enregistre le certificat dans un fichier. (Hérité de CertificateICertificate2) |
| Modèle | Retourne le modèle associé au certificat. (Hérité de CertificateICertificate2) |
Propriétés
L’objet Certificate possède ces propriétés.
| Propriété | Type d’accès | Description |
|---|---|---|
|
Archived |
Lecture/écriture |
Définit ou récupère une valeur booléenne qui indique si le certificat est archivé. (Hérité de CertificateICertificate2) |
|
IssuerName |
Lecture seule |
Récupère une chaîne qui contient le nom de l’émetteur du certificat. (Hérité de CertificateICertificate2ICertificate) |
|
PrivateKey |
Lecture/écriture |
Définit ou récupère la clé privée associée au certificat. (Hérité de CertificateICertificate2) |
|
SerialNumber |
Lecture seule |
Récupère une chaîne qui contient le numéro de série du certificat. (Hérité de CertificateICertificate2ICertificate) |
|
Subjectname |
Lecture seule |
Récupère une chaîne qui contient le nom de l’objet du certificat. (Hérité de CertificateICertificate2ICertificate) |
|
Empreinte numérique |
Lecture seule |
Récupère une chaîne hexadécimale qui contient le hachage SHA-1 du certificat. (Hérité de CertificateICertificate2ICertificate) |
|
ValidFromDate |
Lecture seule |
Récupère la date de début de la validité du certificat. (Hérité de CertificateICertificate2ICertificate) |
|
ValidToDate |
Lecture seule |
Récupère la date de fin pour la validité du certificat. (Hérité de CertificateICertificate2ICertificate) |
|
Version |
Lecture seule |
Récupère le numéro de version du certificat. (Hérité de CertificateICertificate2ICertificate) |
Notes
L’objet Certificate peut être créé et il est sécurisé pour les scripts. Le ProgID de l’objet Certificate est « CAPICOM . Certificate.2 ».
CAPICOM 1. x : Le ProgID de l’objet Certificate est « CAPICOM . Certificate.1 ».
Spécifications
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge des clients |
Windows Vista |
| Fin de la prise en charge des serveurs |
Windows Server 2008 |
| Composant redistribuable |
CAPICOM 2.0 ou version ultérieure sur Windows Server 2003 et Windows XP |
| DLL |
|