Certificate (objeto)
[CAPICOM es un componente solo de 32 bits que está disponible para su uso en los siguientes sistemas operativos: Windows Server 2008, Windows Vista y Windows XP. En su lugar, use la clase X509Certificate2 en el espacio de nombres System.Security.Cryptography.X509Certificates .
El objeto Certificate representa un único certificado digital.
El objeto Certificate expone las siguientes interfaces:
- ICertificate : introducido en CAPICOM 1.0.
- ICertificate2 : introducido en CAPICOM 2.0.
Cuándo se usa
El objeto Certificate se usa para realizar las siguientes tareas:
- Cargue los datos del certificado, incluida la clave privada, desde un archivo.
- Obtenga información del certificado.
- Devuelve restricciones básicas, EKU, propiedades extendidas, extensiones, uso de claves, clave pública y objetos de plantilla asociados al certificado.
- Determine si el certificado es válido y comprueba la disponibilidad de acceso de la clave privada del firmante del certificado.
- Muestra el certificado.
- Importe y exporte el certificado.
- Guarde el certificado en un archivo.
- Recupere o establezca propiedades que describen el certificado.
Miembros
El objeto Certificate tiene estos tipos de miembros:
Métodos
El objeto Certificate tiene estos métodos.
| Método | Descripción |
|---|---|
| BasicConstraints | Devuelve un objeto BasicConstraints que representa la extensión de restricciones básicas del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| Mostrar | Muestra un certificado. (Se hereda de CertificateICertificate2ICertificate) |
| Exportación | Copia un certificado en una cadena codificada. La cadena codificada se puede escribir en un archivo o importarse en un nuevo objeto Certificate . (Se hereda de CertificateICertificate2ICertificate) |
| ExtendedKeyUsage | Devuelve un objeto ExtendedKeyUsage que indica los usos de clave extendida válidos del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| ExtendedProperties | Devuelve una colección de las propiedades extendidas del certificado. (Heredado de CertificateICertificate2) |
| Extensiones | Devuelve una colección de las extensiones asociadas al certificado. (Heredado de CertificateICertificate2) |
| GetInfo | Recupera información del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| HasPrivateKey | Determina si el certificado tiene una clave privada asociada. (Se hereda de CertificateICertificate2ICertificate) |
| Importar | Importa un certificado codificado previamente de una cadena en el objeto Certificate . (Se hereda de CertificateICertificate2ICertificate) |
| IsValid | Crea una cadena de comprobación de certificados para un certificado y devuelve un objeto CertificateStatus que contiene el estado de validez del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| KeyUsage | Devuelve un objeto KeyUsage que indica el uso de clave válido del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| Carga | Importa un certificado de un archivo. (Heredado de CertificateICertificate2) |
| PublicKey | Devuelve un objeto PublicKey . (Heredado de CertificateICertificate2) |
| Guardar | Guarda el certificado en un archivo. (Heredado de CertificateICertificate2) |
| Plantilla | Devuelve la plantilla asociada al certificado. (Heredado de CertificateICertificate2) |
Propiedades
El objeto Certificate tiene estas propiedades.
| Propiedad | Tipo de acceso | Descripción |
|---|---|---|
| Archived |
Lectura/escritura |
Establece o recupera un valor booleano que indica si el certificado está archivado. (Heredado de CertificateICertificate2) |
| IssuerName |
Solo lectura |
Recupera una cadena que contiene el nombre del emisor del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| PrivateKey |
Lectura/escritura |
Establece o recupera la clave privada asociada al certificado. (Heredado de CertificateICertificate2) |
| SerialNumber |
Solo lectura |
Recupera una cadena que contiene el número de serie del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| SubjectName |
Solo lectura |
Recupera una cadena que contiene el nombre del firmante del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| Huella digital |
Solo lectura |
Recupera una cadena hexadecimal que contiene el hash SHA-1 del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| ValidFromDate |
Solo lectura |
Recupera la fecha inicial para la validez del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| ValidToDate |
Solo lectura |
Recupera la fecha de finalización para la validez del certificado. (Se hereda de CertificateICertificate2ICertificate) |
| Versión |
Solo lectura |
Recupera el número de versión del certificado. (Se hereda de CertificateICertificate2ICertificate) |
Comentarios
Se puede crear el objeto Certificate y es seguro para el scripting. El ProgID del objeto Certificate es "CAPICOM. Certificate.2".
CAPICOM 1. x: El ProgID del objeto Certificate es "CAPICOM. Certificate.1".
Requisitos
| Requisito | Value |
|---|---|
| Fin de compatibilidad de cliente |
Windows Vista |
| Fin de compatibilidad de servidor |
Windows Server 2008 |
| Redistribuible |
CAPICOM 2.0 o posterior en Windows Server 2003 y Windows XP |
| Archivo DLL |
|
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de