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 |
|
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour