CryptXmlCreateReference function
The CryptXmlCreateReference function creates a reference to an XML signature.
Syntax
HRESULT WINAPI CryptXmlCreateReference( _In_ HCRYPTXML hCryptXml, DWORD dwFlags, _In_opt_ LPCWSTR wszId, _In_opt_ LPCWSTR wszURI, _In_opt_ LPCWSTR wszType, _In_ const CRYPT_XML_ALGORITHM *pDigestMethod, ULONG cTransform, _In_ const CRYPT_XML_ALGORITHM *rgTransform, _Out_ HCRYPTXML *phReference );
Parameters
- hCryptXml [in]
-
The handle of the XML signature.
- dwFlags
-
Specifies flags that affect how the reference is created.
Currently defined dwFlags values are shown in the following table.
- wszId [in, optional]
-
A pointer to a null-terminated Unicode string that contains the value of the ID attribute of the Reference element of the signature. If this parameter is NULL, then the ID attribute is not created. If this parameter is an empty string, then the ID attribute with empty value is created.
- wszURI [in, optional]
-
A pointer to a null-terminated Unicode string that contains the value of the URI attribute of the Reference element of the signature. If this parameter is an empty string, then the URI attribute with an empty value is created.
- wszType [in, optional]
-
A pointer to a null-terminated Unicode string that contains the value of the Type attribute of the Reference element of the signature. The processing engine does not check or use this attribute.
- pDigestMethod [in]
-
A pointer to a CRYPT_XML_ALGORITHM structure that contains the digest method.
- cTransform
-
The number of elements in the array pointed to by the rgTransform parameter.
- rgTransform [in]
-
A pointer to an ordered array of CRYPT_XML_ALGORITHM structures that contain transform algorithms to be applied to the reference data before the digest calculation.
- phReference [out]
-
A pointer to a reference handle.
Return value
If the function succeeds, the function returns zero.
If the function fails, it returns an HRESULT value that indicates the error.
Requirements
|
Minimum supported client |
Windows 7 [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 R2 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|