NCryptVerifySignature avec le fournisseur de stockage de clés (KSP) - AWS CloudHSM

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 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 decbHashValue.

cbHashValue[en]

Taille de la pbHashValue mé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 decbSignature.

cbSignature[en]

Taille de la pbSignature mé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 une BCRYPT_PKCS1_PADDING_INFO structure.

CRYPT_PAD_PSS_FLAG

Indique la signature utilisée dans le remplissage du schéma de signature probabiliste (PSS). pPaddingInfoDéfini pour pointer vers une BCRYPT_PSS_PADDING_INFO structure.

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'hKeyest pas valide.

BATE_BAD_FLAGS

Le dwFlags paramètre contient une valeur non valide.

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.