CryptXmlOpenToDecode function (cryptxml.h)
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.
Syntax
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
);
Parameters
[in, optional] pConfig
The handle of the transform chain engine. If this parameter is NULL, then a default engine will be used to apply transforms.
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.
[in] rgProperty
A pointer to an array of CRYPT_XML_PROPERTY structures that contain additional properties.
cProperty
The number of items in the array pointed to by the rgProperty parameter.
[in] pEncoded
A pointer to CRYPT_XML_BLOB structure that contains the signature to decode.
phCryptXml
The handle of a Document Context object. When you have finished using the handle, release it by passing it to the CryptXmlClose function.
Return value
If the function succeeds, the function returns zero.
If the function fails, it returns an HRESULT value that indicates the error.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 7 [desktop apps only] |
Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
Target Platform | Windows |
Header | cryptxml.h |
Library | Cryptxml.lib |
DLL | Cryptxml.dll |