CryptHashSessionKey-Funktion (wincrypt.h)
Vor dem Aufrufen dieser Funktion muss CryptCreateHash aufgerufen werden, um das Handle eines Hashobjekts zu erstellen.
Syntax
BOOL CryptHashSessionKey(
[in] HCRYPTHASH hHash,
[in] HCRYPTKEY hKey,
[in] DWORD dwFlags
);
Parameter
[in] hHash
Ein Handle für das Hashobjekt.
[in] hKey
Ein Handle für das Schlüsselobjekt, das gehasht werden soll.
[in] dwFlags
Der folgende Flagwert wird definiert.
Wert | Bedeutung |
---|---|
|
Wenn dieses Flag festgelegt ist, werden die Bytes des Schlüssels in Little-Endian-Form gehasht. Beachten Sie, dass standardmäßig (wenn dwFlags null ist) die Bytes des Schlüssels in Big-Endian-Form gehasht werden. |
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.
Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.
Die von "NTE" vorangestellten Fehlercodes werden von dem jeweiligen CSP generiert, den Sie verwenden. Es folgen einige mögliche Fehlercodes.
Rückgabecode | Beschreibung |
---|---|
|
Einer der Parameter gibt ein ungültiges Handle an. |
|
Einer der Parameter enthält einen ungültigen Wert. Dies ist in den meisten Fällen ein ungültiger Zeiger. |
|
Das hHash-Handle gibt einen Algorithmus an, der von diesem CSP nicht unterstützt wird. |
|
Der dwFlags-Parameter ist ungleich null. |
|
Das vom hHash-Parameter angegebene Hashobjekt ist ungültig. |
|
Es wurde versucht, einem Hashobjekt Daten hinzuzufügen, das bereits als "fertig" gekennzeichnet ist. |
|
Es wird ein Schlüsselhashalgorithmus verwendet, aber der Sitzungsschlüssel ist nicht mehr gültig. Dieser Fehler wird generiert, wenn der Sitzungsschlüssel vor Abschluss des Hashvorgangs zerstört wird. |
|
Der CSP-Kontext, der beim Erstellen des Hashobjekts angegeben wurde, kann nicht gefunden werden. |
|
Die Funktion ist auf unerwartete Weise fehlgeschlagen. |
Anforderungen
Anforderung | Wert |
---|---|
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 |