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