Compartilhar via


Método IX509Extension::Initialize (certenroll.h)

O método Initialize inicializa um objeto IX509Extension usando um OID ( identificador de objeto ) e uma matriz de bytes que contém a extensão codificada de DER (Distinguished Encoding Rules ). A matriz de bytes codificada em DER é representada por uma cadeia de caracteres codificada por Unicode. Esse método está habilitado para a Web.

Sintaxe

HRESULT Initialize(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Parâmetros

[in] pObjectId

Ponteiro para uma interface IObjectId que contém a extensão OID.

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação Unicode aplicada à cadeia de caracteres de entrada.

[in] strEncodedData

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

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
CERTSRV_E_PROPERTY_EMPTY
Não foi possível encontrar a OID.

Observações

Uma extensão de certificado consiste em um OID, um valor booliano que identifica se a extensão é crítica e uma matriz de bytes que contém o valor da extensão. A extensão é definida por um padrão ASN.1 ( Abstract Syntax Notation One ) e é codificada usando DER. Você deve especificar a matriz de bytes codificada em DER como uma cadeia de caracteres que seja uma sequência binária pura ou codificada em Unicode. Você pode especificar o tipo de codificação a ser aplicado à cadeia de caracteres usando a enumeração EncodingType .

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

IX509Extension