Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# NCryptCreatePersistedKey con el proveedor de almacenamiento de claves (KSP)
<a name="ksp-library-apis-create-persisted-key"></a>

La función `NCryptCreatePersistedKey` crea una nueva clave y la almacena en el proveedor de almacenamiento de claves (KSP). Puede usar la función [`NCryptSetProperty`](ksp-library-apis-set-property.md) para establecer sus propiedades después de la creación. Debe llamar a [`NCryptFinalizeKey`](ksp-library-apis-finalize-key.md) antes de poder usar la clave.

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

 `hProvider` [entrada]   
El identificador del proveedor de almacenamiento de claves donde se creará la clave. Use [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md) para obtener este identificador.

 `phKey` [salida]   
La dirección de una variable `NCRYPT_KEY_HANDLE` que almacena el identificador de la clave. 

 `pszAlgId` [entrada]   
Un puntero a una cadena Unicode terminada en nulo que especifica el identificador del algoritmo criptográfico para crear la clave.  
AWS CloudHSM El proveedor de almacenamiento de claves (KSP) admite los siguientes algoritmos:     
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

`pszKeyName` [entrada, opcional]  
Un puntero a una cadena Unicode terminada en nulo que contiene el nombre de la clave. Si este parámetro es NULL, esta función creará una clave efímera que no se conserva.

`dwLegacyKeySpec` [entrada, sin usar]  
AWS CloudHSM El proveedor de almacenamiento de claves (KSP) no usa este parámetro.

`dwFlags` [entrada]  
Indicadores para modificar el comportamiento de la función. Use cero o uno o más de los siguientes valores:    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

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

La función devuelve un código de estado para indicar si la operación se realizó correctamente o si se produjo un error.

Los códigos de retorno comunes incluyen:


****  

| Código de retorno | Description (Descripción) | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  La función se completó correctamente.  | 
|  NTE\$1INVALID\$1PARAMETER  |  Uno o más parámetros no son válidos.  | 
|  NTE\$1FAIL  |  La operación no se pudo completar.  | 
|  NTE\$1BAD\$1FLAGS  |  El parámetro `dwFlags` contiene un valor que no es válido.  | 
|  NTE\$1NOT\$1SUPPORTED  |  El parámetro `pszAlgId` contiene un valor que no se admite.  | 
|  NTE\$1EXISTS  |  Ya existe una clave con el nombre especificado y la operación no usó ` NCRYPT_OVERWRITE_KEY_FLAG`.  |