Compartilhar via


Interface ICspStatus (certenroll.h)

Um objeto ICspStatus contém informações sobre um par de provedores/algoritmos criptográficos. O objeto é usado principalmente pelo Controle de Registro de Certificado para permitir que um usuário selecione quais provedores criptográficos e algoritmos usar ao criar uma solicitação de certificado. Ele pode ser recuperado, sozinho ou em uma coleção ICspStatuses , chamando as seguintes propriedades ou métodos:

Propriedade/método Interface Descrição
GetCspStatusFromOperations ICspInformation Cria um objeto ICspStatus para o primeiro algoritmo com suporte que é consistente com um OID (identificador de objeto de algoritmo) e um tipo de algoritmo especificados.
GetCspStatusesFromOperations ICspInformations Cria uma coleção ICspStatuses para um tipo de algoritmo especificado e informações opcionais do provedor.
Nota O Controle de Registro de Certificado usa uma coleção ICspStatuses somente para a seleção de algoritmo de chave privada assimétrica (criptografia, assinatura e troca de chaves).
 
GetCspStatusFromProviderName ICspInformations Cria um objeto ICspStatus para um provedor herdado por nome do provedor e operações de chave com suporte.
CspStatus IX509PrivateKey Especifica ou recupera um objeto ICspStatus . O objeto normalmente é criado durante o processo de registro.
GetCspStatuses IX509CertificateRequestPkcs10 Cria uma coleção ICspStatuses que contém todos os pares de provedor/algoritmo consistentes com o uso pretendido da chave privada, conforme especificado pelo chamador.
CspStatuses IX509CertificateRequestPkcs10 Cria uma coleção ICspStatuses que contém todos os pares de provedor/algoritmo consistentes com o uso pretendido da chave privada, conforme identificado pelo objeto IX509PrivateKey associado à solicitação de certificado.
 

Como os provedores criptográficos normalmente dão suporte a mais de um algoritmo, vários objetos ICspStatus podem ser criados e retornados quando você chama qualquer uma das propriedades ou métodos anteriores que retornam uma coleção. Isso é mostrado pela ilustração a seguir:

Estrutura da coleção ICspStatuses mostrando objetos ICspStatus individuais

Você pode usar a propriedade EnrollmentStatus em um objeto ICspStatus para recuperar um objeto IX509EnrollmentStatus que define as seguintes propriedades:

  • A propriedade Display especifica se o par provedor/algoritmo pode ser exibido em uma interface do usuário.
  • A propriedade Selected especifica ou recupera um valor que indica se o status de um item específico é monitorado durante o processo de registro.
  • A propriedade Status identifica o status do processo de registro.

Herança

A interface ICspStatus herda da interface IDispatch . O ICspStatus também tem estes tipos de membros:

Métodos

A interface ICspStatus tem esses métodos.

 
ICspStatus::get_CspAlgorithm

Recupera um objeto ICspAlgorithm que contém informações sobre um algoritmo compatível com o provedor.
ICspStatus::get_CspInformation

Recupera um objeto ICspInformation que contém informações gerais sobre o provedor.
ICspStatus::get_DisplayName

Recupera uma cadeia de caracteres que contém o nome do provedor, o nome do algoritmo e as operações que podem ser executadas pelo algoritmo.
ICspStatus::get_EnrollmentStatus

Recupera um objeto IX509EnrollmentStatus que contém informações sobre o registro de certificado.
ICspStatus::get_Ordinal

Especifica ou recupera a posição do objeto ICspStatus na coleção ICspStatuses. (Obter)
ICspStatus::Initialize

Inicializa o objeto de um provedor criptográfico e de um algoritmo associado.
ICspStatus::p ut_Ordinal

Especifica ou recupera a posição do objeto ICspStatus na coleção ICspStatuses. (Put)

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certenroll.h

Confira também

CertEnroll Interfaces

ICspStatuses

IDispatch