Método IX509ExtensionBasicConstraints::InitializeDecode (certenroll.h)
O método InitializeDecode inicializa a extensão de uma matriz de bytes codificada em Distinguished Encoding Rules (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 valor strEncodedData .
[in] strEncodedData
Uma variável BSTR que contém a extensão codificada em DER.
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ê poderá usar esse método se tiver um objeto ASN.1 ( Abstract Syntax Notation One ) codificado em DER que contenha uma extensão BasicConstraints . 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 IX509ExtensionBasicConstraints . Os dois métodos se complementam. O método InitializeEncode permite que você construa um objeto de extensão ASN.1 codificado em DER de dados brutos 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 (identificador de objeto ).
- 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.
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 |