Compartilhar via


Método ICspStatus::get_EnrollmentStatus (certenroll.h)

A propriedade EnrollmentStatus recupera um objeto IX509EnrollmentStatus que contém informações sobre o registro de certificado.

Esta propriedade é somente para leitura.

Sintaxe

HRESULT get_EnrollmentStatus(
  IX509EnrollmentStatus **ppValue
);

Parâmetros

ppValue

Valor retornado

Nenhum

Comentários

Essa propriedade retorna um objeto IX509EnrollmentStatus . Esse objeto normalmente é preenchido quando você cria uma solicitação de certificado PKCS nº 10. As três propriedades a seguir retornadas por esse objeto fornecem informações sobre o par provedor/algoritmo representado por um objeto ICspStatus :

  • A propriedade Display especifica se o provedor e o algoritmo devem ser exibidos em uma interface do usuário.
  • A propriedade Selected especifica se o provedor e o algoritmo podem ser usados para criar um par de chaves para uma solicitação de certificado.
  • A propriedade Status especifica se o provedor e o algoritmo foram ignorados ou resultaram em um erro durante a inicialização da solicitação.

Para entender como essas propriedades são importantes, suponha que uma solicitação de certificado seja baseada em um modelo que especifica um provedor e um algoritmo específicos. As propriedades Display e Status para esse par de provedor/algoritmo estão habilitadas. Para outros objetos ICspStatus , uma ou ambas as propriedades podem não estar habilitadas. Para obter exemplos mais completos, consulte a propriedade Ordinal .

A propriedade Status é definida como EnrollUnknown quando o objeto IX509EnrollmentStatus é criado pela primeira vez. Se um par de provedores/algoritmos não estiver selecionado, o status poderá ser definido como EnrollSkipped. O status será definido como EnrollError se a criação de chave falhar para o provedor e o algoritmo selecionados durante a inicialização do certificado.

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
DLL CertEnroll.dll

Confira também

ICspStatus

ICspStatuses