Partager via


CryptXmlOpenToDecode, fonction (cryptxml.h)

La fonction CryptXmlOpenToDecode ouvre une signature numérique XML pour décoder et retourne le handle du contexte de document qui encapsule une structure CRYPT_XML_SIGNATURE . Le contexte du document peut inclure un ou plusieurs éléments Signature .

Syntaxe

HRESULT CryptXmlOpenToDecode(
  [in, optional] const CRYPT_XML_TRANSFORM_CHAIN_CONFIG *pConfig,
                 DWORD                                  dwFlags,
  [in]           const CRYPT_XML_PROPERTY               *rgProperty,
                 ULONG                                  cProperty,
  [in]           const CRYPT_XML_BLOB                   *pEncoded,
                 HCRYPTXML                              *phCryptXml
);

Paramètres

[in, optional] pConfig

Handle du moteur de chaîne de transformation. Si ce paramètre a la valeur NULL, un moteur par défaut est utilisé pour appliquer des transformations.

dwFlags

Valeur DWORD qui contrôle les extensions CryptXML qui sont chargées et si le code XML est sérialisé. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
CRYPT_XML_FLAG_NO_SERIALIZE
0x80000000
Inhiber la sérialisation.
Important Ne définissez pas cet indicateur lorsque plusieurs threads accèdent à un objet CryptXml. La sérialisation garantit l’exclusion mutuelle lorsque deux threads ou plus tentent d’accepter simultanément un objet ou une mémoire CryptXml.
 
CRYPT_XML_FLAG_DISABLE_EXTENSIONS
0x10000000
Seules les implémentations par défaut de la signature et de la synthèse sont utilisées. Lorsque cet indicateur est défini, aucune autre extension inscrite n’est chargée.

[in] rgProperty

Pointeur vers un tableau de structures CRYPT_XML_PROPERTY qui contiennent des propriétés supplémentaires.

cProperty

Nombre d’éléments du tableau vers rgProperty .

[in] pEncoded

Pointeur vers CRYPT_XML_BLOB structure qui contient la signature à décoder.

phCryptXml

Handle d’un objet Document Context. Lorsque vous avez terminé d’utiliser le handle, relâchez-le en le transmettant à la fonction CryptXmlClose .

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