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\$1SUCCESS  |  A função foi concluída com êxito.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Um ou mais parâmetros não são válidos.  | 
|  NTE\$1FAIL  |  A operação não foi concluída.  | 
|  NTE\$1BAD\$1FLAGS  |  O parâmetro `dwFlags` contém um valor inválido.  | 
|  NTE\$1NOT\$1SUPPORTED  |  O parâmetro `pszAlgId` contém um valor não suportado.  | 
|  NTE\$1EXISTS  |  Já existe uma chave com o nome especificado e a operação não usou ` NCRYPT_OVERWRITE_KEY_FLAG`.  |