PFN_CRYPT_SIGN_AND_ENCODE_HASH_FUNC fonction de rappel (wincrypt.h)

  • Article

La fonction de rappel PFN_CRYPT_SIGN_AND_ENCODE_HASH_FUNC est appelée pour signer et encoder un hachage calculé.

Syntaxe

PFN_CRYPT_SIGN_AND_ENCODE_HASH_FUNC PfnCryptSignAndEncodeHashFunc;

BOOL PfnCryptSignAndEncodeHashFunc(
  [in]      NCRYPT_KEY_HANDLE hKey,
  [in]      DWORD dwCertEncodingType,
  [in]      PCRYPT_ALGORITHM_IDENTIFIER pSignatureAlgorithm,
  [in]      void *pvDecodedSignPara,
  [in]      LPCWSTR pwszCNGPubKeyAlgid,
  [in]      LPCWSTR pwszCNGHashAlgid,
  [in]      BYTE *pbComputedHash,
  [in]      DWORD cbComputedHash,
  [out]     BYTE *pbSignature,
  [in, out] DWORD *pcbSignature
)
{...}

Paramètres

[in] hKey

Handle de l’API de chiffrement : clé privée CNG (Next Generation) à utiliser pour signer le hachage.

[in] dwCertEncodingType

Spécifie le type d’encodage utilisé. Il est toujours acceptable de spécifier les types d’encodage de certificat et de message en les combinant avec une opération OR au niveau du bit, comme illustré dans l’exemple suivant :

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING types d’encodage actuellement définis sont les suivants :

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pSignatureAlgorithm

Pointeur vers une structure CRYPT_ALGORITHM_IDENTIFIER qui contient l’identificateur d’objet de signature (OID) et ses paramètres encodés facultatifs.

[in] pvDecodedSignPara

Pointeur facultatif vers la structure de données des paramètres de signature décodée précédemment retournée par la fonction PFN_CRYPT_EXTRACT_ENCODED_SIGNATURE_PARAMETERS_FUNC .

[in] pwszCNGPubKeyAlgid

Chaîne Unicode qui contient l’identificateur d’algorithme de clé publique CNG qui correspond à pSignatureAlgorithm-pszObjId>.

[in] pwszCNGHashAlgid

Chaîne Unicode qui contient l’identificateur d’algorithme de hachage CNG qui correspond à pSignatureAlgorithm-pszObjId> ou à un identificateur d’algorithme de hachage dans pvDecodedSignPara.

[in] pbComputedHash

Pointeur vers les octets de hachage calculés retournés par la fonction BCryptFinishHash qui correspond à pwszCNGHashAlgid.

[in] cbComputedHash

Valeur qui représente la longueur, en octets, du hachage calculé.

[out] pbSignature

Pointeur vers les octets de signature encodés.

[in, out] pcbSignature

Valeur qui représente la longueur, en octets, de la signature encodée.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro (TRUE).

Si la fonction échoue, elle retourne zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Si cette fonction de rappel ne prend pas en charge l’algorithme de signature, elle doit retourner FALSE et appeler SetLastError avec ERROR_NOT_SUPPORTED.

Remarques

Vous pouvez utiliser les fonctions de support OID pour déployer cette fonction de rappel. Wincrypt.h définit la constante suivante à cet effet.

Constant Définition
CRYPT_OID_SIGN_AND_ENCODE_HASH_FUNC « CryptDllSignAndEncodeHash »

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wincrypt.h