Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# NCryptCreatePersistedKey con Key Storage Provider (KSP)
<a name="ksp-library-apis-create-persisted-key"></a>

La `NCryptCreatePersistedKey` funzione crea una nuova chiave e la memorizza nel Key Storage Provider (KSP). È possibile utilizzare la [`NCryptSetProperty`](ksp-library-apis-set-property.md)funzione per impostarne le proprietà dopo la creazione. È necessario chiamare [`NCryptFinalizeKey`](ksp-library-apis-finalize-key.md)prima di poter utilizzare la chiave.

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

 `hProvider`[in]   
L'handle del provider di archiviazione delle chiavi in cui verrà creata la chiave. [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md)Usalo per ottenere questa maniglia.

 `phKey`[fuori]   
L'indirizzo di una `NCRYPT_KEY_HANDLE` variabile che memorizza l'handle della chiave. 

 `pszAlgId`[in]   
Un puntatore a una stringa Unicode con terminazione nulla che specifica l'identificatore dell'algoritmo crittografico per la creazione della chiave.  
AWS CloudHSM Key Storage Provider (KSP) supporta i seguenti algoritmi:     
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

`pszKeyName`[in, opzionale]  
Un puntatore a una stringa Unicode con terminazione nulla che contiene il nome della chiave. Se questo parametro è NULL, questa funzione creerà una chiave effimera che non è persistente.

`dwLegacyKeySpec`[in, non utilizzato]  
AWS CloudHSM Key Storage Provider (KSP) non utilizza questo parametro.

`dwFlags`[nel]  
Bandiere per modificare il comportamento della funzione. Utilizzate zero o più dei seguenti valori:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

## Valore restituito
<a name="ksp-library-apis-create-persisted-key-return-value"></a>

La funzione restituisce un codice di stato per indicare l'esito positivo o negativo.

I codici di restituzione comuni includono:


****  

| Codice di restituzione | Description | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  La funzione è stata completata con successo.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Uno o più parametri non sono validi.  | 
|  NOTE\$1FAIL  |  L'operazione non è stata completata.  | 
|  NET\$1BAD\$1FLAGS  |  Il `dwFlags` parametro contiene un valore non valido.  | 
|  NOT\$1NOT\$1SUPPORTED  |  Il `pszAlgId` parametro contiene un valore non supportato.  | 
|  NTE\$1EXISTS  |  Esiste già una chiave con il nome specificato e l'operazione non è stata utilizzata. ` NCRYPT_OVERWRITE_KEY_FLAG`  |