Funzione NCryptDeleteKey (ncrypt.h)

  • Articolo

La funzione NCryptDeleteKey elimina una chiave CNG.

Sintassi

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

Parametri

[in] hKey

Handle della chiave da eliminare. Questo handle viene ottenuto usando la funzione NCryptOpenKey .

Nota La funzione NCryptDeleteKey elimina la chiave e libera l'handle. Le applicazioni possono usare la funzione NCryptFreeObject per liberare l'handle se NCryptDeleteKey ha esito negativo.
 

[in] dwFlags

Flag che modificano il comportamento della funzione. Può essere zero o una combinazione di valori specifici per ogni provider di archiviazione delle chiavi.

Valore Significato
NCRYPT_SILENT_FLAG
 Richiede che il provider di servizi chiave (KSP) non visualizzi alcuna interfaccia utente. Se il provider deve visualizzare l'interfaccia utente per il funzionamento, la chiamata ha esito negativo e il provider di servizi di configurazione deve impostare il codice di errore NTE_SILENT_CONTEXT come ultimo errore.

Valore restituito

Restituisce un codice di stato che indica l'esito positivo o negativo della funzione.

I codici restituiti possibili includono, a titolo esemplificativo, quanto segue.

Codice restituito Descrizione
ERROR_SUCCESS
 La funzione ha avuto esito positivo.
NTE_BAD_FLAGS
 Il parametro dwFlags contiene un valore non valido.
NTE_INVALID_HANDLE
 Il parametro hKey non è valido.

Commenti

Un servizio non deve chiamare questa funzione dalla funzione StartService. Se un servizio chiama questa funzione dalla funzione StartService, può verificarsi un deadlock e il servizio potrebbe smettere di rispondere.

Requisiti

   
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione ncrypt.h
Libreria Ncrypt.lib
DLL Ncrypt.dll

Vedi anche

NCryptOpenKey