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

O método Initialize inicializa o objeto de um OID ( identificador de objeto de algoritmo de chave pública) e de matrizes de bytes que contêm uma chave pública e os parâmetros associados, se houver. As matrizes de bytes são representadas por cadeias de caracteres codificadas em Unicode.

Sintaxe

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

Parâmetros

[in] pObjectId

Ponteiro para uma interface IObjectId que representa o algoritmo OID.

[in] strEncodedKey

Uma variável BSTR que contém a chave pública.

[in] strEncodedParameters

Uma variável BSTR que contém os parâmetros associados à chave pública. Para obter mais informações, consulte a propriedade EncodedParameters .

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação Unicode aplicado aos argumentos especificados nos parâmetros strEncodedKey e strEncodedParameters . O valor padrão é XCN_CRYPT_STRING_BASE64.

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

Comentários

O método Initialize inicializa os seguintes valores de propriedade:

• Algoritmo
• EncodedKey
• EncodedParameters
• Comprimento

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

Confira também

IX509PublicKey