CryptHashCertificate2-Funktion (wincrypt.h)

Artikel
03/13/2024

Die CryptHashCertificate2-Funktion hasht einen Datenblock mithilfe eines CNG-Hashanbieters.

Syntax

BOOL CryptHashCertificate2(
  [in]      LPCWSTR    pwszCNGHashAlgid,
  [in]      DWORD      dwFlags,
            void       *pvReserved,
  [in]      const BYTE *pbEncoded,
  [in]      DWORD      cbEncoded,
  [out]     BYTE       *pbComputedHash,
  [in, out] DWORD      *pcbComputedHash
);

Parameter

[in] pwszCNGHashAlgid

Die Adresse einer mit NULL beendeten Unicode-Zeichenfolge, die den CNG-Hashalgorithmusbezeichner des Hashalgorithmus enthält, der zum Hashen des Zertifikats verwendet werden soll. Dies kann einer der CNG-Algorithmusbezeichner sein, der einen Hashalgorithmus oder einen anderen registrierten Hashalgorithmusbezeichner darstellt.

[in] dwFlags

Eine Reihe von Flags, die das Verhalten dieser Funktion ändern. Für diese Funktion sind keine Flags definiert.

pvReserved

Für die zukünftige Verwendung reserviert und muss NULL sein.

[in] pbEncoded

Die Adresse eines Arrays von Bytes, die gehasht werden sollen. Der cbEncoded-Parameter enthält die Größe dieses Arrays.

[in] cbEncoded

Die Anzahl der Elemente im pbEncoded-Array .

[out] pbComputedHash

Die Adresse eines Puffers, der den berechneten Hash empfängt. Die Variable, auf die der parameter pcbComputedHash verweist, enthält die Größe dieses Puffers.

[in, out] pcbComputedHash

Die Adresse einer DWORD-Variablen , die beim Eintrag die Größe des Puffers pbComputedHash in Bytes enthält. Nachdem diese Funktion zurückgegeben wurde, enthält diese Variable die Anzahl der Bytes, die in den Puffer pbComputedHash kopiert wurden.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero (TRUE) zurück.

Wenn die Funktion fehlschlägt, gibt sie null (FALSE) zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Einige der möglichen Fehlercodes werden in den folgenden Themen identifiziert.

BCryptOpenAlgorithmProvider

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll

Weitere Informationen

Datenverwaltung-Funktionen