Objeto Certificate
[CAPICOM é um componente somente de 32 bits que está disponível para uso nos seguintes sistemas operacionais: Windows Server 2008, Windows Vista e Windows XP. Em vez disso, use a classe X509Certificate2 no namespace System.Security.Cryptography.X509Certificates .]
O objeto Certificate representa um único certificado digital.
O objeto Certificate expõe as seguintes interfaces:
- ICertificate — introduzido no CAPICOM 1.0.
- ICertificate2 — introduzido no CAPICOM 2.0.
Quando usar
O objeto Certificate é usado para executar as seguintes tarefas:
- Carregue dados de certificado, incluindo a chave privada, de um arquivo.
- Obtenha informações do certificado.
- Retornar restrições básicas, EKU, propriedades estendidas, extensões, uso de chave, chave pública e objetos de modelo associados ao certificado.
- Determine se o certificado é válido e marcar a disponibilidade de acesso da chave privada da entidade do certificado.
- Exiba o certificado.
- Importe e exporte o certificado.
- Salve o certificado em um arquivo.
- Recupere ou defina propriedades que descrevem o certificado.
Membros
O objeto Certificate tem estes tipos de membros:
Métodos
O objeto Certificate tem esses métodos.
| Método | Descrição |
|---|---|
| BasicConstraints | Retorna um objeto BasicConstraints que representa a extensão de restrições básicas do certificado. (Herdado de CertificateICertificate2ICertificate) |
| Exibir | Exibe um certificado. (Herdado de CertificateICertificate2ICertificate) |
| Exportação | Copia um certificado para uma cadeia de caracteres codificada. A cadeia de caracteres codificada pode ser gravada em um arquivo ou importada para um novo objeto Certificate . (Herdado de CertificateICertificate2ICertificate) |
| ExtendedKeyUsage | Retorna um objeto ExtendedKeyUsage que indica os usos válidos de chave estendida do certificado. (Herdado de CertificateICertificate2ICertificate) |
| ExtendedProperties | Retorna uma coleção das propriedades estendidas do certificado. (Herdado de CertificateICertificate2) |
| Extensões | Retorna uma coleção das extensões associadas ao certificado. (Herdado de CertificateICertificate2) |
| GetInfo | Recupera informações do certificado. (Herdado de CertificateICertificate2ICertificate) |
| HasPrivateKey | Determina se o certificado tem uma chave privada associada a ele. (Herdado de CertificateICertificate2ICertificate) |
| Importaçãoação | Importa um certificado codificado anteriormente de uma cadeia de caracteres para o objeto Certificate . (Herdado de CertificateICertificate2ICertificate) |
| Isvalid | Cria uma cadeia de verificação de certificado para um certificado e retorna um objeto CertificateStatus que contém a validade status do certificado. (Herdado de CertificateICertificate2ICertificate) |
| KeyUsage | Retorna um objeto KeyUsage que indica o uso válido da chave do certificado. (Herdado de CertificateICertificate2ICertificate) |
| Carga | Importa um certificado de um arquivo. (Herdado de CertificateICertificate2) |
| Publickey | Retorna um objeto PublicKey . (Herdado de CertificateICertificate2) |
| Salvar | Salva o certificado em um arquivo. (Herdado de CertificateICertificate2) |
| Modelo | Retorna o modelo associado ao certificado. (Herdado de CertificateICertificate2) |
Propriedades
O objeto Certificate tem essas propriedades.
| Propriedade | Tipo de acesso | Descrição |
|---|---|---|
|
Archived |
Leitura/gravação |
Define ou recupera um valor booliano que indica se o certificado está arquivado. (Herdado de CertificateICertificate2) |
|
Issuername |
Somente leitura |
Recupera uma cadeia de caracteres que contém o nome do emissor do certificado. (Herdado de CertificateICertificate2ICertificate) |
|
Privatekey |
Leitura/gravação |
Define ou recupera a chave privada associada ao certificado. (Herdado de CertificateICertificate2) |
|
SerialNumber |
Somente leitura |
Recupera uma cadeia de caracteres que contém o número de série do certificado. (Herdado de CertificateICertificate2ICertificate) |
|
Subjectname |
Somente leitura |
Recupera uma cadeia de caracteres que contém o nome da entidade do certificado. (Herdado de CertificateICertificate2ICertificate) |
|
Impressão digital |
Somente leitura |
Recupera uma cadeia de caracteres hexadecimal que contém o hash SHA-1 do certificado. (Herdado de CertificateICertificate2ICertificate) |
|
ValidFromDate |
Somente leitura |
Recupera a data de início da validade do certificado. (Herdado de CertificateICertificate2ICertificate) |
|
ValidToDate |
Somente leitura |
Recupera a data final para a validade do certificado. (Herdado de CertificateICertificate2ICertificate) |
|
Versão |
Somente leitura |
Recupera o número de versão do certificado. (Herdado de CertificateICertificate2ICertificate) |
Comentários
O objeto Certificate pode ser criado e é seguro para scripts. O ProgID do objeto Certificate é "CAPICOM. Certificate.2".
CAPICOM 1. x: o ProgID para o objeto Certificate é "CAPICOM. Certificate.1".
Requisitos
| Requisito | Valor |
|---|---|
| Fim do suporte ao cliente |
Windows Vista |
| Fim do suporte ao servidor |
Windows Server 2008 |
| Redistribuível |
CAPICOM 2.0 ou posterior no Windows Server 2003 e Windows XP |
| DLL |
|