Freigeben über


NCryptDeleteKey-Funktion (ncrypt.h)

Die NCryptDeleteKey-Funktion löscht einen CNG-Schlüssel.

Syntax

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

Parameter

[in] hKey

Das Handle des zu löschenden Schlüssels. Dieses Handle wird mithilfe der NCryptOpenKey-Funktion abgerufen.

Hinweis Die NCryptDeleteKey-Funktion löscht den Schlüssel und gibt den Handle frei. Anwendungen können die NCryptFreeObject-Funktion verwenden, um das Handle frei zu geben, wenn NCryptDeleteKey fehlschlägt.
 

[in] dwFlags

Flags, die das Funktionsverhalten ändern. Dies kann null oder eine Kombination von Werten sein, die für jeden Schlüsselspeicheranbieter spezifisch sind.

Wert Bedeutung
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

   
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

Weitere Informationen

NCryptOpenKey