BCryptDestroySecret-Funktion (bcrypt.h)

Die BCryptDestroySecret Funktion zerstört ein geheimes Vertragshandle, das mithilfe der BCryptSecretAgreement Funktion erstellt wurde.

Syntax

NTSTATUS BCryptDestroySecret(
  [in] BCRYPT_SECRET_HANDLE hSecret
);

Parameter

[in] hSecret

Die zu zerstörenden BCRYPT_SECRET_HANDLE.

Rückgabewert

Gibt einen Statuscode zurück, der den Erfolg oder Fehler der Funktion angibt.

Mögliche Rückgabecodes umfassen, aber nicht beschränkt auf Folgendes.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion war erfolgreich.
STATUS_INVALID_HANDLE	Das Handle im hSecret Parameter ist ungültig.

Bemerkungen

Je nachdem, welche Prozessormodi ein Anbieter unterstützt, können BCryptDestroySecret- entweder über den Benutzermodus oder den Kernelmodus aufgerufen werden. Kernelmodusaufrufer können entweder PASSIVE_LEVELIRQL- oder DISPATCH_LEVEL IRQL ausgeführt werden. Wenn die aktuelle IRQL-Ebene DISPATCH_LEVEList, muss das im hSecret Parameter bereitgestellte Handle von einem Algorithmushandle abgeleitet werden, das von einem Anbieter zurückgegeben wird, der mithilfe des BCRYPT_PROV_DISPATCH Flags geöffnet wurde.

Um diese Funktion im Kernelmodus aufzurufen, verwenden Sie Cng.lib, das Teil des Driver Development Kit (DDK) ist. Windows Server 2008 und Windows Vista: Verwenden Sie Ksecdd.lib, um diese Funktion im Kernelmodus aufzurufen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [Desktop-Apps | UWP-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform-	Fenster
Header-	bcrypt.h
Library	Bcrypt.lib
DLL-	Bcrypt.dll

Siehe auch

BCryptSecretAgreement