Método ISignerCertificate::Initialize (certenroll.h)

O método Initialize inicializa o objeto de um certificado de assinatura.

Sintaxe

HRESULT Initialize(
  [in] VARIANT_BOOL         MachineContext,
  [in] X509PrivateKeyVerify VerifyType,
  [in] EncodingType         Encoding,
  [in] BSTR                 strCertificate
);

Parâmetros

[in] MachineContext

Uma variável VARIANT_BOOL que indica se o contexto do repositório de certificados do computador local ou o contexto do usuário deve ser pesquisado para localizar o certificado identificado pelo parâmetro strCertificate . Especifique VARIANT_TRUE para o computador e VARIANT_FALSE para o usuário.

[in] VerifyType

Um valor de enumeração X509PrivateKeyVerify que especifica se a chave privada usada para assinar o certificado deve ser verificada e, nesse caso, se a verificação deve ser silenciosa ou permite a entrada do usuário.

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação Unicode aplicada à cadeia de caracteres de certificado codificada de DER ( Distinguished Encoding Rules ).

[in] strCertificate

Uma variável BSTR que contém o certificado codificado em DER.

Começando com o Windows 7 e o Windows Server 2008 R2, você pode especificar uma impressão digital do certificado ou um número de série em vez de um certificado codificado. Isso faz com que a função pesquise os repositórios locais apropriados para o certificado correspondente. Tenha em mente os seguintes pontos:

• O BSTR deve ser um número par de dígitos hexadecimal.
• O espaço em branco entre pares hexadecimal é ignorado.
• O parâmetro de codificação deve ser definido como XCN_CRYPT_STRING_HEXRAW.
• O parâmetro MachineContext determina se o usuário ou o computador armazena ou ambos são pesquisados.
• Se uma chave privada for necessária, somente os repositórios pessoais e de solicitação serão pesquisados.
• Se uma chave privada não for necessária, os repositórios de AC raiz e intermediária também serão pesquisados.

Valor de retorno

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

O método Initialize :

• Verifica se a chave privada associada ao certificado existe.
• Cria um objeto IX509SignatureInformation e o atribui ao objeto ISignerCertificate .
• Recupera o algoritmo de chave pública da chave privada.
• Atribui o algoritmo de chave pública ao objeto IX509SignatureInformation .

Defina as seguintes propriedades antes de chamar Initialize:

• ParentWindow
• Fixar
• Silent
• UIContextMessage

Requirements

Consulte também

ISignerCertificate