CryptXmlOpenToEncode function (cryptxml.h)
If CryptXmlOpenToEncode function opens an XML digital signature to encode and returns a handle of the opened Signature element. The handle encapsulates a document context with a single CRYPT_XML_SIGNATURE structure and remains open until the CryptXmlClose function is called.
HRESULT CryptXmlOpenToEncode(
[in, optional] const CRYPT_XML_TRANSFORM_CHAIN_CONFIG *pConfig,
DWORD dwFlags,
[in, optional] LPCWSTR wszId,
[in] const CRYPT_XML_PROPERTY *rgProperty,
[in] ULONG cProperty,
[in, optional] const CRYPT_XML_BLOB *pEncoded,
[optional] HCRYPTXML *phSignature
);
[in, optional] pConfig
The handle of the transform chain engine. If this parameter is NULL, then a default engine is 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, optional] wszId
A pointer to a null-terminated Unicode string that contains the Id attribute of the Signature element. If this parameter is NULL, then a new GUID is generated. If this parameter is an empty string, then no Id attribute is produced.
[in] rgProperty
A pointer to an array of CRYPT_XML_PROPERTY structures that specify additional properties.
[in] cProperty
The number of elements in the array pointed to by the rgProperty parameter.
[in, optional] pEncoded
A pointer to a CRYPT_XML_BLOB structure that contains the signature to encode.
[optional] phSignature
The handle to the Signature element.
If the function succeeds, the function returns zero.
If the function fails, it returns an HRESULT value that indicates the error.
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 |