Freigeben über


CryptDestroyHash-Funktion (wincrypt.h)

Wichtig Diese API ist veraltet. Neue und vorhandene Software sollte mit der Verwendung von Kryptografie-APIs der nächsten Generation beginnen. Microsoft kann diese API in zukünftigen Versionen entfernen.
 
Die CryptDestroyHash-Funktion zerstört das Hashobjekt, auf das vom hHash-Parameter verwiesen wird. Nachdem ein Hashobjekt zerstört wurde, kann es nicht mehr verwendet werden.

Um die Sicherheit zu gewährleisten, wird empfohlen, Hashobjekte zu zerstören, nachdem sie verwendet wurden.

Syntax

BOOL CryptDestroyHash(
  [in] HCRYPTHASH hHash
);

Parameter

[in] hHash

Das Handle des zu zerstörenden Hashobjekts.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Die von "NTE" vorangestellten Fehlercodes werden von dem jeweiligen kryptografischen Dienstanbieter (CSP ) generiert, den Sie verwenden. Es folgen einige mögliche Fehlercodes.

Rückgabecode Beschreibung
ERROR_BUSY
Das von hHash angegebene Hashobjekt wird derzeit verwendet und kann nicht zerstört werden.
ERROR_INVALID_HANDLE
Der hHash-Parameter gibt ein ungültiges Handle an.
ERROR_INVALID_PARAMETER
Der hHash-Parameter enthält einen ungültigen Wert.
NTE_BAD_ALGID
Das hHash-Handle gibt einen Algorithmus an, der von diesem CSP nicht unterstützt wird.
NTE_BAD_HASH
Das vom hHash-Parameter angegebene Hashobjekt ist ungültig.
NTE_BAD_UID
Der CSP-Kontext, der beim Erstellen des Hashobjekts angegeben wurde, kann nicht gefunden werden.

Hinweise

Wenn ein Hashobjekt zerstört wird, überschreiben viele CSPs den Speicher in dem CSP, in dem das Hashobjekt gespeichert wurde. Der CSP-Speicher wird dann freigegeben.

Zwischen Aufrufen von CryptCreateHash und CryptDestroyHash sollte eine 1:1-Korrespondenz bestehen.

Alle Hashobjekte, die mit einem bestimmten CSP erstellt wurden, müssen zerstört werden, bevor dieses CSP-Handle mit der CryptReleaseContext-Funktion freigegeben wird.

Beispiele

Ein Beispiel, das die CryptDestroyHash-Funktion verwendet, finden Sie unter Beispiel-C-Programm: Erstellen und Hashen eines Sitzungsschlüssels.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wincrypt.h
Bibliothek Advapi32.lib
DLL Advapi32.dll

Weitere Informationen

CryptCreateHash

CryptHashData

CryptSignHash

Hash- und digitale Signaturfunktionen