Método IX509CertificateRequestCmc::get_SignatureInformation (certenroll.h)

  • Artigo

A propriedade SignatureInformation recupera o objeto IX509SignatureInformation que contém informações sobre a assinatura primária usada para assinar a solicitação de certificado. Essa propriedade está habilitada para a Web.

Esta propriedade é somente para leitura.

Sintaxe

HRESULT get_SignatureInformation(
  IX509SignatureInformation **ppValue
);

Parâmetros

ppValue

Valor retornado

Nenhum

Comentários

O objeto IX509SignatureInformation contém informações sobre os algoritmos de hash, chave pública e assinatura usados para a assinatura primária que assina a solicitação de certificado. Uma solicitação CMC pode ter uma assinatura primária mais zero ou mais assinaturas baseadas em certificado. As assinaturas baseadas em certificado poderão ser incluídas em uma solicitação se, por exemplo, uma ou mais partes adicionais precisarem atestar a identidade da entidade que solicita o novo certificado. Você pode chamar a propriedade SignerCertificates para recuperar uma coleção dessas assinaturas adicionais baseadas em certificado.

A assinatura primária normalmente é criada usando a chave privada que corresponde à chave pública no objeto de solicitação PKCS nº 10 interno. Como a chave privada geralmente é criada para registrar uma nova solicitação em uma hierarquia de certificado, a assinatura primária não é baseada em certificado e você deve chamar a propriedade SignatureInformation para recuperá-la.

Se o objeto IX509SignatureInformation não existir quando a propriedade SignatureInformation for chamada ou a criação da assinatura tiver sido adiada durante a inicialização, esta propriedade:

  • Recupera o objeto de solicitação PKCS nº 10 interno.
  • Recupera e duplica as informações de assinatura da solicitação interna.
  • Tenta recuperar a chave privada associada ao PKCS nº 10 interno e define a propriedade NullSigned se nenhuma chave privada puder ser encontrada.
  • Recupera o algoritmo de hash, se for especificado, do modelo associado à solicitação interna e define a propriedade HashAlgorithm .
  • Recupera o algoritmo assimétrico, se for especificado, da chave privada associada à solicitação interna e define a propriedade PublicKeyAlgorithm .
  • Recupera os sinalizadores de chave privada do modelo e define o AlternateSignatureAlgorithm , se apropriado

Você deve inicializar o objeto de solicitação do CMC antes de chamar essa propriedade. Para obter mais informações, consulte estes tópicos:

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

IX509CertificateRequestCmc

IX509CertificateRequestPkcs10