Fonction de rappel CryptXmlDllSignData (cryptxml.h)

Article
02/26/2024

La fonction CryptXmlDllSignData signe des données.

La fonction CryptXmlDllSignData est exposée via la fonction CryptXmlDllGetInterface exportée.

Syntaxe

CryptXmlDllSignData Cryptxmldllsigndata;

HRESULT Cryptxmldllsigndata(
  [in]            const CRYPT_XML_ALGORITHM *pSignatureMethod,
  [in]            HCRYPTPROV_OR_NCRYPT_KEY_HANDLE hCryptProvOrNCryptKey,
  [in]            DWORD dwKeySpec,
  [in]            const BYTE *pbInput,
  [in]            ULONG cbInput,
  [out, optional] BYTE *pbOutput,
  [in]            ULONG cbOutput,
  [out]           ULONG *pcbResult
)
{...}

Paramètres

[in] pSignatureMethod

Pointeur vers une structure CRYPT_XML_ALGORITHM qui spécifie l’algorithme.

[in] hCryptProvOrNCryptKey

Handle du fournisseur de services de chiffrement (CSP) qui crée la signature. Ce handle doit être un handle HCRYPTPROV obtenu à partir d’un appel à la fonction CryptAcquireContext ou d’un handle NCRYPT_KEY_HANDLE créé à l’aide de la fonction NCryptOpenKey . Les nouvelles applications doivent passer un NCRYPT_KEY_HANDLE handle.

[in] dwKeySpec

Clé privée à utiliser à partir du conteneur du fournisseur. Cette clé peut être AT_KEYEXCHANGE ou AT_SIGNATURE. Ce paramètre est ignoré si un handle NCRYPT_KEY_HANDLE est utilisé dans le paramètre hCryptProvOrNCryptKey .

[in] pbInput

Pointeur vers une mémoire tampon qui contient la valeur digeste à signer. Le paramètre cbInput contient la taille de cette mémoire tampon.

[in] cbInput

Taille, en octets, de la mémoire tampon pointée vers le paramètre pbInput .

[out, optional] pbOutput

Adresse d’une mémoire tampon pour recevoir la signature produite par cette fonction. Le paramètre cbOutput contient la taille de cette mémoire tampon.

Si ce paramètre a la valeur NULL, cette fonction calcule la taille nécessaire pour les données chiffrées et retourne la taille à l’emplacement pointé par le paramètre pcbResult .

[in] cbOutput

Taille, en octets, de la mémoire tampon pointée vers le paramètre pbOutput .

[out] pcbResult

Pointeur vers une variable DWORD qui reçoit le nombre d’octets copiés dans la mémoire tampon pbOutput . Si pbOutput a la valeur NULL, il reçoit la taille, en octets, requise pour la signature.

Valeur retournée

Si la fonction réussit, la fonction retourne zéro.

Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur.

Configuration requise

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

Share via