NCryptFinalizeKey-Funktion (ncrypt.h)

  • Artikel

Die NCryptFinalizeKey-Funktion schließt einen CNG-Schlüsselspeicherschlüssel ab. Der Schlüssel kann erst verwendet werden, wenn diese Funktion aufgerufen wurde.

Syntax

SECURITY_STATUS NCryptFinalizeKey(
  [in] NCRYPT_KEY_HANDLE hKey,
  [in] DWORD             dwFlags
);

Parameter

[in] hKey

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

[in] dwFlags

Flags, die das Funktionsverhalten ändern. Dies kann null oder eine Kombination aus einem oder mehreren der folgenden Werte sein.

Wert Bedeutung
NCRYPT_NO_KEY_VALIDATION
 Überprüfen Sie nicht den öffentlichen Teil des Schlüsselpaars. Dieses Flag gilt nur für öffentliche/private Schlüsselpaare.
NCRYPT_WRITE_KEY_TO_LEGACY_STORE_FLAG
 Speichern Sie den Schlüssel auch im Legacyspeicher. Dadurch kann der Schlüssel mit CryptoAPI verwendet werden. Dieses Flag gilt nur für RSA-Schlüssel.
NCRYPT_SILENT_FLAG
 Fordert an, dass der Schlüsseldienstanbieter (Key Service Provider, KSP) keine Benutzeroberfläche anzeigt. Wenn der Anbieter die Benutzeroberfläche anzeigen muss, um zu funktionieren, schlägt der Aufruf fehl, und der KSP sollte den NTE_SILENT_CONTEXT Fehlercode als letzten Fehler festlegen.

Rückgabewert

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

Mögliche Rückgabecodes umfassen folgendes, sind aber nicht darauf beschränkt.

Rückgabecode Beschreibung
ERROR_SUCCESS
 Die Funktion war erfolgreich.
NTE_BAD_FLAGS
 Der dwFlags-Parameter enthält einen wert, der ungültig ist.
NTE_INVALID_HANDLE
 Der hKey-Parameter ist ungültig.

Hinweise

Ein Dienst darf diese Funktion nicht über seine StartService-Funktion aufrufen. Wenn ein Dienst diese Funktion über seine StartService-Funktion aufruft, kann ein Deadlock auftreten, und der Dienst reagiert möglicherweise nicht mehr.

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 ncrypt.h
Bibliothek Ncrypt.lib
DLL Ncrypt.dll