Función NCryptDeleteKey (ncrypt.h)

La función NCryptDeleteKey elimina una clave CNG.

Sintaxis

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

Parámetros

[in] hKey

Identificador de la clave que se va a eliminar. Este identificador se obtiene mediante la función NCryptOpenKey .

Nota La función NCryptDeleteKey elimina la clave y libera el identificador. Las aplicaciones pueden usar la función NCryptFreeObject para liberar el identificador si se produce un error en NCryptDeleteKey .

 

[in] dwFlags

Marcas que modifican el comportamiento de la función. Puede ser cero o una combinación de valores específicos de cada proveedor de almacenamiento de claves.

Value	Significado
NCRYPT_SILENT_FLAG	Solicita que el proveedor de servicios clave (KSP) no muestre ninguna interfaz de usuario. Si el proveedor debe mostrar la interfaz de usuario para funcionar, se produce un error en la llamada y el KSP debe establecer el código de error NTE_SILENT_CONTEXT como último error.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función.

Entre los códigos de retorno posibles se incluyen, entre otros, los siguientes.

Código devuelto	Descripción
ERROR_SUCCESS	La función se realizó correctamente.
NTE_BAD_FLAGS	El parámetro dwFlags contiene un valor que no es válido.
NTE_INVALID_HANDLE	El parámetro hKey no es válido.

Comentarios

Un servicio no debe llamar a esta función desde su función StartService. Si un servicio llama a esta función desde su función StartService, se puede producir un interbloqueo y el servicio puede dejar de responder.

Requisitos

Cliente mínimo compatible	Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	ncrypt.h
Library	Ncrypt.lib
Archivo DLL	Ncrypt.dll

Consulte también

NCryptOpenKey