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 do 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 retornado
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 |
|---|---|
|
O objeto já está inicializado. |
Comentários
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 (Abstract Syntax Notation One) codificado em Distinguished Encoding Rules (DER), e o método InitializeDecode permite inicializar os dados brutos de um objeto codificado.
Você pode recuperar as seguintes propriedades para essa 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 inicializar 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 .
Requisitos
| 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 |