Compartilhar via

Método IX509AttributeRenewalCertificate::InitializeDecode (certenroll.h)

  • Artigo

O método InitializeDecode inicializa o objeto de uma matriz de bytes codificada em Distinguished Encoding Rules (DER) que contém o certificado a ser renovado. A matriz de bytes é representada por uma cadeia de caracteres codificada em Unicode.

Sintaxe

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parâmetros

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação Unicode aplicada à cadeia de caracteres de entrada.

[in] strEncodedData

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

A partir do Windows 7 e do 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 Encoding deve ser definido como XCN_CRYPT_STRING_HEXRAW.
  • 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.

Retornar valor

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. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

O OID (identificador de objeto ) para esse atributo é XCN_OID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1). Para obter mais informações, consulte CERTENROLL_OBJECTID.

Você poderá usar esse método se tiver um objeto ASN.1 ( Abstract Syntax Notation One ) codificado em DER que contenha o valor do atributo. Você deve fornecer o objeto codificado em DER em uma cadeia de caracteres codificada em Unicode. Para obter mais informações, consulte a interface IBinaryConverter .

Você deve chamar InitializeEncode ou InitializeDecode antes de usar um objeto IX509AttributeRenewalCertificate . Os dois métodos se complementam. O método InitializeEncode permite que você construa uma estrutura ASN.1 codificada com base em dados brutos e o método InitializeDecode permite inicializar dados brutos de uma estrutura ASN.1 codificada. Você pode chamar a propriedade RenewalCertificate para recuperar os dados brutos.

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

IX509AttributeRenewalCertificate