nf-cryptxml-cryptxmlopentodecode.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:cryptxml.CryptXmlOpenToDecode	CryptXmlOpenToDecode function (cryptxml.h)	Opens an XML digital signature to decode and returns the handle of the document context that encapsulates a CRYPT_XML_SIGNATURE structure. The document context can include one or more Signature elements.	CRYPT_XML_FLAG_DISABLE_EXTENSIONS CRYPT_XML_FLAG_NO_SERIALIZE CryptXmlOpenToDecode CryptXmlOpenToDecode function [Security] cryptxml/CryptXmlOpenToDecode security.cryptxmlopentodecode	security\cryptxmlopentodecode.htm	security	b6a77d62-b92d-4b83-949f-14a0ce3ce025	12/05/2018	CRYPT_XML_FLAG_DISABLE_EXTENSIONS, CRYPT_XML_FLAG_NO_SERIALIZE, CryptXmlOpenToDecode, CryptXmlOpenToDecode function [Security], cryptxml/CryptXmlOpenToDecode, security.cryptxmlopentodecode	cryptxml.h		Windows	Windows 7 [desktop apps only]	Windows Server 2008 R2 [desktop apps only]										Cryptxml.lib	Cryptxml.dll		Windows			19H1	CryptXmlOpenToDecode cryptxml/CryptXmlOpenToDecode	c++	APIRef kbSyntax	DllExport	Cryptxml.dll	CryptXmlOpenToDecode

CryptXmlOpenToDecode function

-description

The CryptXmlOpenToDecode function opens an XML digital signature to decode and returns the handle of the document context that encapsulates a CRYPT_XML_SIGNATURE structure. The document context can include one or more Signature elements.

-parameters

-param pConfig [in, optional]

The handle of the transform chain engine. If this parameter is NULL, then a default engine will be used to apply transforms.

-param dwFlags

A DWORD value that controls which CryptXML extensions are loaded and whether the XML is serialized. This parameter can be one of the following values.

Value	Meaning
CRYPT_XML_FLAG_NO_SERIALIZE 0x80000000	Inhibit serialization. Important  Do not set this flag when multiple threads are accessing a CryptXml object. Serialization ensures mutual exclusion when two or more threads attempt to simultaneously accept a CryptXml object or memory.
CRYPT_XML_FLAG_DISABLE_EXTENSIONS 0x10000000	Only default implementations for the signature and digest are used. When this flag is set, no other registered extensions are loaded.

-param rgProperty [in]

A pointer to an array of CRYPT_XML_PROPERTY structures that contain additional properties.

-param cProperty

The number of items in the array pointed to by the rgProperty parameter.

-param pEncoded [in]

A pointer to CRYPT_XML_BLOB structure that contains the signature to decode.

-param phCryptXml

The handle of a Document Context object. When you have finished using the handle, release it by passing it to the CryptXmlClose function.

-returns

If the function succeeds, the function returns zero.

If the function fails, it returns an HRESULT value that indicates the error.