ICertPropertyArchivedKeyHash::Initialize-Methode (certenroll.h)

Artikel
02/28/2024

Die Initialize-Methode initialisiert das Objekt aus einem Bytearray, das den Hash enthält. Das Bytearray wird als Unicode-codierte Zeichenfolge dargestellt.

Syntax

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

Parameter

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf die Eingabezeichenfolge angewendet wird.

[in] strArchivedKeyHashValue

Eine BSTR-Variable , die einen SHA-1-Hash des verschlüsselten privaten Schlüssels enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode/-wert	BESCHREIBUNG
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Das Objekt ist bereits initialisiert.

Hinweise

Rufen Sie die SetValueOnCertificate-Methode auf , um die Eigenschaft einem Zertifikat zuzuordnen. Rufen Sie die ArchivedKeyHash-Eigenschaft auf, um den Hash abzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll

Weitere Informationen

ArchivePrivateKey

ICertPropertyArchivedKeyHash

KeyArchivalCertificate

Freigeben über