BCryptFinalizeKeyPair-Funktion (bcrypt.h)

Artikel
07/16/2024

Die BCryptFinalizeKeyPair Funktion schließt ein öffentliches/privates Schlüsselpaarab. Der Schlüssel kann erst verwendet werden, wenn diese Funktion aufgerufen wurde. Nachdem diese Funktion aufgerufen wurde, kann die BCryptSetProperty--Funktion nicht mehr für diesen Schlüssel verwendet werden.

Syntax

NTSTATUS BCryptFinalizeKeyPair(
  [in, out] BCRYPT_KEY_HANDLE hKey,
  [in]      ULONG             dwFlags
);

Parameter

[in, out] hKey

Der Ziehpunkt des zu schließenden Schlüssels. Dieses Handle wird durch Aufrufen der BCryptGenerateKeyPair-Funktion abgerufen.

[in] dwFlags

Eine Reihe von Flags, die das Verhalten dieser Funktion ändern. Derzeit sind keine Flags definiert, daher sollte dieser Parameter null sein.

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 Schlüsselhandle im hKey--Parameter ist ungültig.
STATUS_INVALID_PARAMETER	Mindestens ein Parameter ist ungültig.
STATUS_NOT_SUPPORTED	Der angegebene Anbieter unterstützt keine asymmetrische Schlüsselverschlüsselung.

Bemerkungen

Je nachdem, welche Prozessormodi ein Anbieter unterstützt, kann BCryptFinalizeKeyPair 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 hKey Parameter bereitgestellte Handle von einem Algorithmushandle abgeleitet werden, das von einem Anbieter zurückgegeben wurde, der mit dem BCRYPT_PROV_DISPATCH-Flag 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

BCryptGenerateKeyPair

Freigeben über