Método IX509ExtensionSmimeCapabilities::InitializeDecode (certenroll.h)

  • Artigo

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 em DER é 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 aplicado ao parâmetro strEncodedData .

[in] strEncodedData

Uma variável BSTR que contém a extensão codificada em DER.

Retornar valor

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
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 O objeto já está inicializado.

Comentários

Você poderá usar esse método se tiver um objeto ASN.1 codificado em DER que contenha uma extensão SmimeCapabilities . 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 IX509ExtensionSmimeCapabilities . 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 da extensão.
  • A propriedade SmimeCapabilities recupera a coleção de funcionalidades (os dados brutos da extensão).

Requisitos

Requisito Valor
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

Confira também

IX509ExtensionSmimeCapabilities