Compartilhar via


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

O método InitializeEncode inicializa a extensão de uma coleção de OIDs (identificadores de objeto IObjectId ) que especificam os usos pretendidos da chave pública. Esse método está habilitado para a Web.

Sintaxe

HRESULT InitializeEncode(
  [in] IObjectIds *pValue
);

Parâmetros

[in] pValue

Ponteiro para uma interface IObjectIds .

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.

Código/valor de retorno Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
O objeto já está inicializado.

Observações

Você deve chamar InitializeEncode ou InitializeDecode antes de usar um objeto IX509ExtensionEnhancedKeyUsage . 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 ( identificador de objeto de extensão).
  • A propriedade EnhancedKeyUsage recupera a coleção de OIDs que identificam os usos pretendidos da chave pública (os dados de extensão brutos).

Requirements

Requirement Value
Cliente mínimo suportado Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo compatível Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
Header certenroll.h
de DLL CertEnroll.dll

Consulte também

IX509ExtensionEnhancedKeyUsage