NCryptFreeObject-Funktion (ncrypt.h)

Die NCryptFreeObject-Funktion gibt ein CNG-Schlüsselspeicherobjekt frei.

Syntax

SECURITY_STATUS NCryptFreeObject(
  [in] NCRYPT_HANDLE hObject
);

Parameter

[in] hObject

Das Handle des frei zu gebenden Objekts. Dies kann entweder ein Anbieterhandle (NCRYPT_PROV_HANDLE) oder ein Schlüsselhandle (NCRYPT_KEY_HANDLE) sein.

Rückgabewert

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

Mögliche Rückgabecodes sind u. a. die folgenden:

Rückgabecode Beschreibung
ERROR_SUCCESS
Die Funktion war erfolgreich.
NTE_INVALID_HANDLE
Das Handle im hObject-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

Weitere Informationen

NCryptOpenStorageProvider