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

O método InitializeDecode inicializa a extensão de uma matriz de bytes codificada em DER que contém o valor da extensão. A matriz de bytes codificada é representada por uma cadeia de caracteres codificada por 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 ao parâmetro strEncodedData .

[in] strEncodedData

Uma variável BSTR que contém a extensão codificada em DER.

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

Você poderá usar esse método se tiver um objeto ASN.1 (Abstract Syntax Notation One) codificado por DER (Distinguished Encoding Rules) que contenha uma extensão CertificateTemplate. Você deve fornecer o objeto codificado em DER em uma cadeia de caracteres codificada unicode. Para obter mais informações, consulte a interface IBinaryConverter .

Você deve chamar InitializeEncode ou InitializeDecode antes de usar um objeto IX509ExtensionTemplate . Os dois métodos se complementam. O método InitializeEncode permite que você construa um objeto de extensão ASN.1 codificado em DER com base em dados brutos e o método InitializeDecode permite que você inicialize os dados brutos de um objeto codificado.

Você pode recuperar as seguintes propriedades para esta extensão:

• A propriedade Critical identifica se a extensão é crítica. Você também pode especificar essa propriedade.
• A propriedade ObjectId recupera o OID (identificador de objeto ).
• As propriedades MajorVersion e MinorVersion recuperam as informações de versão.
• A propriedade TemplateOid recupera o OID do modelo.

Requirements

Consulte também

IX509ExtensionTemplate