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

  • Artigo

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 em Distinguished Encoding Rules (DER). A matriz de bytes codificada em DER é representada por uma cadeia de caracteres codificada em 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.

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

Comentários

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 esteja codificada em Unicode. Você pode especificar o tipo de codificação a ser aplicado à cadeia de caracteres usando a enumeração EncodingType .

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

IX509Extension