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

O método InitializeEncode inicializa a extensão de um OID ( identificador de objeto de modelo) e de números de versão principal e secundária. Esse método está habilitado para a Web.

Sintaxe

HRESULT InitializeEncode(
  [in] IObjectId *pTemplateOid,
  [in] LONG      MajorVersion,
  [in] LONG      MinorVersion
);

Parâmetros

[in] pTemplateOid

Ponteiro para uma interface IObjectId que representa o OID de modelo.

[in] MajorVersion

Uma variável LONG que contém o número de versão principal do modelo. O valor padrão é zero (0).

[in] MinorVersion

Uma variável LONG que contém o número de versão secundária do modelo. O valor padrão é zero (0).

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ê 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 DER ( Distinguished Encoding Rules ) codificado em Asn.1 ( Abstract Syntax Notation One ) de 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.
• As propriedades MajorVersion e MinorVersion recuperam as informações de versão.
• A propriedade TemplateOid recupera o OID do modelo.

Você deve chamar InitializeEncode ou InitializeDecode antes de usar um objeto IX509ExtensionBasicConstraints . 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 que você inicialize os dados brutos de uma estrutura ASN.1 codificada. Você pode recuperar os dados brutos da extensão chamando as propriedades MajorVersion, MinorVersion e TemplateOid .

Requirements

Consulte também

IX509ExtensionTemplate