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.
NCryptVerifySignature avec le fournisseur de stockage de clés (KSP)
La NCryptVerifySignature fonction confirme si une signature correspond à un hachage spécifié.
Paramètres
-
hKey[en] -
Le descripteur de la clé à utiliser pour déchiffrer la signature. Vous devez utiliser la partie clé publique de la paire de clés utilisée pour signer les données avec le NCryptSignHash.
pPaddingInfo[en, facultatif]-
Un 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 de la
pbHashValuemémoire tampon en octets. pbSignature[dehors]-
Adresse d'un tampon contenant le hachage signé des données. NCryptSignHashÀ utiliser pour créer cette signature. Spécifiez la taille de la mémoire tampon à l'aide de
cbSignature. cbSignature[en]-
Taille de la
pbSignaturemémoire tampon en octets. NCryptSignHashÀ utiliser pour créer la signature. 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 DRAPEAU NCRYPT_PAD_ PKCS1
Indique la signature utilisée dans le PKCS1 rembourrage.
pPaddingInfoDéfini pour pointer vers uneBCRYPT_PKCS1_PADDING_INFOstructure.CRYPT_PAD_PSS_FLAG
Indique la signature utilisée dans le remplissage du schéma de signature probabiliste (PSS).
pPaddingInfoDéfini pour pointer 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 |
|
NOTE_BAD_SIGNATURE |
La signature n'a pas été vérifiée. |
|
NOTE_BAD_KEY_STATE |
L'état de la clé n'est pas valide. |
|
ERREUR_INTERNE |
Une erreur interne s'est produite lors de la vérification de la signature. |