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)
La NCryptSignHash fonction crée la signature d'une valeur de hachage.
Paramètres
-
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
dwFlagsvaleur. 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
pbHashValuemé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
pbSignaturemémoire tampon en octets. La fonction ignore ce paramètre s'ilpbSignatureest NULL. pcbResult[dehors]-
Pointeur vers une variable DWORD qui stocke le nombre d'octets copiés dans la
pbSignaturemémoire tampon.Si la valeur
pbSignatureest 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 :
Valeur Signification BCRYPT_PAD_ PKCS1
Utilise le schéma PKCS1 de rembourrage.
pPaddingInfoDéfini pour pointer vers uneBCRYPT_PKCS1_PADDING_INFOstructure.BCRYPT_PAD_PSS
Utilise le schéma de remplissage PSS (Probabilistic Signature Scheme). Définissez
pPaddingInfole paramètre pour qu'il pointe vers uneBCRYPT_PSS_PADDING_INFOstructure.INCRYPT_SILENT_FLAG
Ce drapeau n'a aucun effet.
Valeur renvoyée
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. |
|
NOTE_INVALID_HANDLE |
Le handle in n' |
|
BATE_BAD_FLAGS |
Le |
|
NTE_BUFFER_TOO_SMALL |
Le |
|
NOTE_BAD_KEY_STATE |
L'état de la clé n'est pas valide. |
|
ERREUR_INTERNE |
Une erreur interne s'est produite lors de la signature du hachage. |
