

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.

# NCryptSignHash avec le fournisseur de stockage de clés (KSP)
<a name="ksp-library-apis-sign-hash"></a>

La `NCryptSignHash` fonction crée la signature d'une valeur de hachage.

## Parameters
<a name="ksp-library-apis-sign-hash-parameters"></a>

 `hKey`[en]   
 Le manche de la clé à utiliser pour signer le hachage. 

`pPaddingInfo`[en, facultatif]  
Pointeur vers une structure contenant des informations de remplissage. Le type de structure dépend de la `dwFlags` valeur. Utilisez ce paramètre uniquement avec des clés asymétriques ; défini sur NULL pour les autres types de clés.

`pbHashValue`[en]  
Un pointeur vers un tampon contenant la valeur de hachage à signer. Spécifiez la taille de la mémoire tampon à l'aide de`cbHashValue`.

`cbHashValue`[en]  
Taille, en octets, de la `pbHashValue` mémoire tampon à signer.

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

`cbSignature`[en]  
Taille de la `pbSignature` mémoire tampon en octets. La fonction ignore ce paramètre s'il `pbSignature` est NULL.

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

`dwFlags`[en]  
Drapeaux permettant de modifier le comportement de la fonction. Les drapeaux autorisés dépendent du type de clé. Utilisez l'une des valeurs suivantes :    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/cloudhsm/latest/userguide/ksp-library-apis-sign-hash.html)

## Valeur renvoyée
<a name="ksp-library-apis-sign-hash-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\$1SUCCÈS  |  L'opération s'est terminée avec succès.  | 
|  PARAMÈTRE\$1INVALIDE  |  Un ou plusieurs paramètres ne sont pas valides.  | 
|  NOTE\$1FAIL  |  L'opération n'a pas pu être terminée.  | 
|  NOTE\$1INVALID\$1HANDLE  |  Le handle in n'`hKey`est pas valide.  | 
|  BATE\$1BAD\$1FLAGS  |  Le `dwFlags` paramètre contient une valeur non valide.  | 
|  NTE\$1BUFFER\$1TOO\$1SMALL  |  Le `pcbOutput` paramètre est trop petit pour les valeurs renvoyées.  | 
|  NOTE\$1BAD\$1KEY\$1STATE  |  L'état de la clé n'est pas valide.  | 
|  ERREUR\$1INTERNE  |  Une erreur interne s'est produite lors de la signature du hachage.  | 