Compartilhar via


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

O método Initialize inicializa o objeto de uma matriz de bytes que contém o hash. A matriz de bytes é representada como uma cadeia de caracteres codificada por Unicode.

Sintaxe

HRESULT Initialize(
  [in] EncodingType Encoding,
  [in] BSTR         strArchivedKeyHashValue
);

Parâmetros

[in] Encoding

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

[in] strArchivedKeyHashValue

Uma variável BSTR que contém um hash SHA-1 da chave privada criptografada.

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

Chame o método SetValueOnCertificate para associar a propriedade a um certificado. Chame a propriedade ArchivedKeyHash para recuperar o hash.

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

ArchivePrivateKey

ICertPropertyArchivedKeyHash

KeyArchivalCertificate