Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# NCryptGetProperty avec le fournisseur de stockage de clés (KSP)
<a name="ksp-library-apis-get-property"></a>

La `NCryptGetProperty` fonction récupère les valeurs des propriétés d'un objet de stockage clé.

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

 `hObject`[en]   
 Le descripteur de l'objet dont vous souhaitez récupérer la propriété. Vous pouvez utiliser :  
+ Un identifiant de fournisseur (`NCRYPT_PROV_HANDLE`)
+ Une poignée à clé (`NCRYPT_KEY_HANDLE`)

 `pszProperty `[en]   
Un pointeur vers une chaîne Unicode terminée par un caractère nul contenant le nom de la propriété à récupérer.   
Lors de son utilisation`NCRYPT_PROV_HANDLE`, le fournisseur de stockage de AWS CloudHSM clés (KSP) prend en charge les identifiants KSP suivants :    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
Lors de son utilisation`NCRYPT_KEY_HANDLE`, le fournisseur de stockage de AWS CloudHSM clés (KSP) prend en charge les identifiants KSP suivants :    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
Les valeurs sont des chaînes de caractères larges littérales, comme indiqué par L avant le littéral.

 `pbOutput`[dehors]   
Adresse d'une mémoire tampon pour stocker la valeur de la propriété. Spécifiez la taille de la mémoire tampon à l'aide de`cbOutput`.  
Pour déterminer la taille de tampon requise, définissez ce paramètre sur NULL. La fonction enregistre la taille requise (en octets) à l'emplacement indiqué par`pcbResult`.

 `cbOutput`[en]   
 Taille de la `pbOutput` mémoire tampon en octets.

`pcbResult`[dehors]  
Pointeur vers une variable DWORD qui stocke le nombre d'octets copiés dans la `pbOutput` mémoire tampon.  
Si la valeur `pbOutput` est NULL, cela stocke la taille requise (en octets).

`dwFlags`[en]  
Drapeaux permettant de modifier le comportement de la fonction. Vous pouvez utiliser zéro ou :    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)
Lorsque PSZProperty l'est`NCRYPT_SECURITY_DESCR_PROPERTY`, utilisez l'un ou une combinaison des éléments suivants :    
****    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/fr_fr/cloudhsm/latest/userguide/ksp-library-apis-get-property.html)

## Valeur renvoyée
<a name="ksp-library-apis-get-property-return-value"></a>

La fonction renvoie un code d'état indiquant le succès ou l'échec.

Les codes de retour courants incluent :


****  

| Code de retour | Description | 
| --- | --- | 
| ERREUR\_SUCCÈS | L'opération s'est terminée avec succès. | 
| PARAMÈTRE\_INVALIDE | Un ou plusieurs paramètres ne sont pas valides. | 
| NOTE\_FAIL | L'opération n'a pas pu être terminée. | 
| BATE\_BAD\_FLAGS | Le `dwFlags` paramètre contient une valeur non valide. | 
| NOTE NON PRISE EN CHARGE | Le `pszAlgId` paramètre contient une valeur qui n'est pas prise en charge. | 
| NOTE\_INVALID\_HANDLE | Le handle in n'`hObject`est pas valide. | 
| NTE\_BUFFER\_TOO\_SMALL | Le `cbOutput` paramètre est trop petit pour les valeurs renvoyées. |