CRYPT_XML_TRANSFORM_INFO structure (cryptxml.h)

The CRYPT_XML_TRANSFORM_INFO structure contains information that is used when applying the data transform.

Syntax

typedef struct _CRYPT_XML_TRANSFORM_INFO {
  ULONG                          cbSize;
  LPCWSTR                        wszAlgorithm;
  ULONG                          cbBufferSize;
  DWORD                          dwFlags;
  PFN_CRYPT_XML_CREATE_TRANSFORM pfnCreateTransform;
} CRYPT_XML_TRANSFORM_INFO, *PCRYPT_XML_TRANSFORM_INFO;

Members

cbSize

The size, in bytes, of this structure.

wszAlgorithm

A pointer to a null-terminated Unicode string that contains the Algorithm attribute.

cbBufferSize

The size, in bytes, of the data provider's buffer. The size can be zero if the size cannot be determined at initialization time. This value is used by a caller of the structure pointed to by the pfnCreateTransform member to determine the necessary size of the receiving buffer.

dwFlags

Specifies values that control how the transform is applied.

This member can be one or more of the following values.

Value Meaning
CRYPT_XML_TRANSFORM_ON_STREAM
0x00000001
Specifies that the input to the transform is a stream of bytes.
CRYPT_XML_TRANSFORM_ON_NODESET
0x00000002
Specifies that the input to the transform is an XML node set.
CRYPT_XML_TRANSFORM_URI_QUERY_STRING
0x00000003
Specifies that the URI comparison is to be performed on the core URI without the QueryString.

In some cases, the URI may contain additional information in the QueryString after the ampersand (&). Use this flag to evaluate only the core URI.

pfnCreateTransform

A pointer to a PFN_CRYPT_XML_CREATE_TRANSFORM callback function used to create the transform.

Remarks

For XML canonicalization transforms, the buffer size specified by the cbBufferSize member must be large enough to accommodate an entire Start element with all attribute values.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header cryptxml.h

See also

Digital Signature Cryptographic Algorithms