As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# NCryptCreatePersistedKey com o provedor de armazenamento de chaves (KSP)
<a name="ksp-library-apis-create-persisted-key"></a>

A função `NCryptCreatePersistedKey` cria uma nova chave e a armazena no Provedor de armazenamento de chaves (KSP). Você pode usar a função [`NCryptSetProperty`](ksp-library-apis-set-property.md) para definir suas propriedades após a criação. Você deve chamar [`NCryptFinalizeKey`](ksp-library-apis-finalize-key.md) antes de poder usar a chave.

## Parâmetros
<a name="ksp-library-apis-create-persisted-key-parameters"></a>

 `hProvider` [in]   
O identificador do provedor de armazenamento de chaves em que você criará a chave. Use [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md) para obter esse identificador.

 `phKey` [out]   
O endereço de uma variável `NCRYPT_KEY_HANDLE` que armazena o identificador da chave. 

 `pszAlgId` [in]   
Um ponteiro para uma string Unicode terminada em nulo que especifica o identificador do algoritmo criptográfico para criar a chave.  
AWS CloudHSM O Key Storage Provider (KSP) suporta os seguintes algoritmos:     
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

`pszKeyName` [in, optional]  
Um ponteiro para uma string Unicode terminada em nulo que contém o nome da chave. Se esse parâmetro for NULL, essa função criará uma chave efêmera que não será persistida.

`dwLegacyKeySpec` [in, unused]  
AWS CloudHSM O Key Storage Provider (KSP) não usa esse parâmetro.

`dwFlags` [in]  
Sinalizadores para modificar o comportamento da função. Use nenhum ou mais dos seguintes valores:    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

## Valor de retorno
<a name="ksp-library-apis-create-persisted-key-return-value"></a>

A função retorna um código de status para indicar êxito ou falha.

Os códigos de retorno comuns incluem:


****  

| Código de retorno | Description | 
| --- | --- | 
| ERROR\_SUCCESS | A função foi concluída com êxito. | 
| NTE\_INVALID\_PARAMETER | Um ou mais parâmetros não são válidos. | 
| NTE\_FAIL | A operação não foi concluída. | 
| NTE\_BAD\_FLAGS | O parâmetro `dwFlags` contém um valor inválido. | 
| NTE\_NOT\_SUPPORTED | O parâmetro `pszAlgId` contém um valor não suportado. | 
| NTE\_EXISTS | Já existe uma chave com o nome especificado e a operação não usou ` NCRYPT_OVERWRITE_KEY_FLAG`. |