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

O método InitializeEncode inicializa a extensão de um valor booliano que indica se a entidade de certificado é uma AC (autoridade de certificação) e um inteiro que contém a profundidade da cadeia de AC subordinada.

Sintaxe

HRESULT InitializeEncode(
  [in] VARIANT_BOOL IsCA,
  [in] LONG         PathLenConstraint
);

Parâmetros

[in] IsCA

Uma variável VARIANT_BOOL que especifica se o assunto do certificado é uma AC.

[in] PathLenConstraint

Uma variável LONG que contém o número máximo de certificados na cadeia.

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

O método associa a coleção de nomes ao identificador de objeto (2.5.29.19) do XCN_OID_BASIC_CONSTRAINTS2 (2.29.19) e a codifica usando DER (Distinguished Encoding Rules ).

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 um objeto de extensão ASN.1 ( Abstract Syntax Notation One ) codificado em DER a partir 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.
• A propriedade IsCA identifica se o titular do certificado pode ser uma autoridade de certificação.
• A propriedade PathLenConstraint identifica a profundidade da cadeia de autoridade de certificação subordinada.

Requirements

Consulte também

IX509ExtensionBasicConstraints