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.

# NCryptGetProperty con el proveedor de almacenamiento de claves (KSP)
<a name="ksp-library-apis-get-property"></a>

La función `NCryptGetProperty` recupera valores de propiedades de un objeto de almacenamiento de claves.

## Parameters
<a name="ksp-library-apis-create-get-property-parameters"></a>

 `hObject` [entrada]   
 El identificador del objeto cuya propiedad desea recuperar. Puede usar:  
+ Un identificador de proveedor (`NCRYPT_PROV_HANDLE`)
+ Un identificador de clave (`NCRYPT_KEY_HANDLE`)

 `pszProperty ` [entrada]   
Un puntero a una cadena Unicode terminada en nulo que contiene el nombre de la propiedad que se va a recuperar.   
Cuando se utiliza`NCRYPT_PROV_HANDLE`, el proveedor de almacenamiento de AWS CloudHSM claves (KSP) admite los siguientes identificadores de KSP:    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
Cuando se utiliza`NCRYPT_KEY_HANDLE`, el proveedor de almacenamiento de AWS CloudHSM claves (KSP) admite los siguientes identificadores de KSP:    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
Los valores son literales de cadena de caracteres anchos, como lo indica la L antes del literal.

 `pbOutput` [salida]   
La dirección de un búfer para almacenar el valor de la propiedad. Especifique el tamaño del búfer mediante `cbOutput`.  
Para determinar el tamaño de búfer requerido, establezca este parámetro en NULL. La función almacena el tamaño requerido (en bytes) en la ubicación a la que apunta `pcbResult`.

 `cbOutput` [entrada]   
 El tamaño del búfer `pbOutput` en bytes.

`pcbResult` [salida]  
Un puntero a una variable DWORD que almacena el número de bytes copiados en el búfer `pbOutput`.  
Si `pbOutput` es NULL, se almacena el tamaño requerido (en bytes).

`dwFlags` [entrada]  
Indicadores para modificar el comportamiento de la función. Puede usar cero o:    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/es_es/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
Cuando pszProperty es `NCRYPT_SECURITY_DESCR_PROPERTY`, use uno o una combinación 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-get-property.html)

## Valor de retorno
<a name="ksp-library-apis-get-property-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\_SUCCESS | La operación se completó correctamente. | 
| NTE\_INVALID\_PARAMETER | Uno o más parámetros no son válidos. | 
| NTE\_FAIL | La operación no se pudo completar. | 
| NTE\_BAD\_FLAGS | El parámetro `dwFlags` contiene un valor que no es válido. | 
| NTE\_NOT\_SUPPORTED | El parámetro `pszAlgId` contiene un valor que no se admite. | 
| NTE\_INVALID\_HANDLE | El identificador en `hObject` no es válido. | 
| NTE\_BUFFER\_TOO\_SMALL | El parámetro `cbOutput` es demasiado pequeño para los valores de retorno. |