Share via

Função NCryptFinalizeKey (ncrypt.h)

  • Artigo

A função NCryptFinalizeKey conclui uma chave de armazenamento de chave CNG. A chave não pode ser usada até que essa função tenha sido chamada.

Sintaxe

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

Parâmetros

[in] hKey

O identificador da chave a ser concluída. Esse identificador é obtido chamando a função NCryptCreatePersistedKey .

[in] dwFlags

Sinalizadores que modificam o comportamento da função. Isso pode ser zero ou uma combinação de um ou mais dos valores a seguir.

Valor Significado
NCRYPT_NO_KEY_VALIDATION
 Não valide a parte pública do par de chaves. Esse sinalizador só se aplica a pares de chaves públicas/privadas.
NCRYPT_WRITE_KEY_TO_LEGACY_STORE_FLAG
 Salve também a chave no armazenamento herdado. Isso permite que a chave seja usada com CryptoAPI. Esse sinalizador só se aplica a chaves RSA.
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

Requisito Valor
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