Função NCryptDeleteKey (ncrypt.h)

A função NCryptDeleteKey exclui uma chave CNG.

Sintaxe

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

Parâmetros

[in] hKey

O identificador da chave a ser excluída. Esse identificador é obtido usando a função NCryptOpenKey .

Nota A função NCryptDeleteKey exclui a chave e libera o identificador. Os aplicativos podem usar a função NCryptFreeObject para liberar o identificador se NCryptDeleteKey falhar.

 

[in] dwFlags

Sinalizadores que modificam o comportamento da função. Isso pode ser zero ou uma combinação de valores específicos para cada provedor de armazenamento de chaves.

Valor	Significado
NCRYPT_SILENT_FLAG	Solicita que o KSP (provedor de serviços de chave) não exiba nenhuma interface do usuário. Se o provedor precisar exibir a interface do usuário para operar, a chamada falhará e o KSP deverá definir o código de erro NTE_SILENT_CONTEXT como o último erro.

Retornar valor

Retorna um código status que indica o êxito ou a falha da função.

Os códigos de retorno possíveis incluem, mas não se limitam a, o seguinte.

Código de retorno	Descrição
ERROR_SUCCESS	A função foi bem-sucedida.
NTE_BAD_FLAGS	O parâmetro dwFlags contém um valor que não é válido.
NTE_INVALID_HANDLE	O parâmetro hKey não é válido.

Comentários

Um serviço não deve chamar essa função de sua função StartService. Se um serviço chamar essa função de sua função StartService, um deadlock poderá ocorrer e o serviço poderá parar de responder.

Requisitos

Cliente mínimo com suporte	Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	ncrypt.h
Biblioteca	Ncrypt.lib
DLL	Ncrypt.dll

Confira também

NCryptOpenKey