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 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 ao parâmetro strEncodedData .

[in] strEncodedData

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

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. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Valor/código retornado	Descrição
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	O objeto já está inicializado.

Comentários

Você poderá usar esse método se tiver um objeto ASN.1 (Abstract Syntax Notation One) codificado em Distinguished Encoding Rules (DER) que contém uma extensão CertificateTemplate. 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 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 inicializar 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.

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

IX509ExtensionTemplate