Fonction CryptXmlCreateReference (cryptxml.h)

Article
02/24/2024

La fonction CryptXmlCreateReference crée une référence à une signature XML.

Syntaxe

HRESULT CryptXmlCreateReference(
  [in]           HCRYPTXML                 hCryptXml,
                 DWORD                     dwFlags,
  [in, optional] LPCWSTR                   wszId,
  [in, optional] LPCWSTR                   wszURI,
  [in, optional] LPCWSTR                   wszType,
  [in]           const CRYPT_XML_ALGORITHM *pDigestMethod,
                 ULONG                     cTransform,
  [in]           const CRYPT_XML_ALGORITHM *rgTransform,
  [out]          HCRYPTXML                 *phReference
);

Paramètres

[in] hCryptXml

Handle de la signature XML.

dwFlags

Spécifie les indicateurs qui affectent la façon dont la référence est créée.

Les valeurs dwFlags actuellement définies sont indiquées dans le tableau suivant.

Valeur	Signification
CRYPT_XML_FLAG_CREATE_REFERENCE_AS_OBJECT 0x00000001	Définissez cet indicateur pour créer un nœud Object et l’ajouter à l’élément Signature . Une référence au nœud Object est créée dans l’élément SignedInfo . Le handle retourné est un nœud Objet encapsulé et peut être utilisé dans les appels suivants à la fonction CryptXmlCreateReference pour créer des références dans le nœud Manifeste .

[in, optional] wszId

Pointeur vers une chaîne Unicode terminée par null qui contient la valeur de l’attribut ID de l’élément Reference de la signature. Si ce paramètre a la valeur NULL, l’attribut ID n’est pas créé. Si ce paramètre est une chaîne vide, l’attribut ID avec la valeur vide est créé.

[in, optional] wszURI

Pointeur vers une chaîne Unicode terminée par null qui contient la valeur de l’attribut URI de l’élément Reference de la signature. Si ce paramètre est une chaîne vide, l’attribut URI avec une valeur vide est créé.

[in, optional] wszType

Pointeur vers une chaîne Unicode terminée par null qui contient la valeur de l’attribut Type de l’élément Reference de la signature. Le moteur de traitement n’case activée ni n’utilise cet attribut.

[in] pDigestMethod

Pointeur vers une structure CRYPT_XML_ALGORITHM qui contient la méthode digest.

cTransform

Nombre d’éléments dans le tableau pointé vers le paramètre rgTransform .

[in] rgTransform

Pointeur vers un tableau ordonné de structures CRYPT_XML_ALGORITHM qui contiennent des algorithmes de transformation à appliquer aux données de référence avant le calcul de synthèse.

[out] phReference

Pointeur vers un handle de référence.

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
Bibliothèque	Cryptxml.lib
DLL	Cryptxml.dll

Partager via