PFN_CRYPT_XML_CREATE_TRANSFORM callback function (cryptxml.h)

Article
02/22/2024

The PFN_CRYPT_XML_CREATE_TRANSFORM callback function creates a transform for a specified data provider.

Syntax

PFN_CRYPT_XML_CREATE_TRANSFORM PfnCryptXmlCreateTransform;

HRESULT PfnCryptXmlCreateTransform(
  [in]  const CRYPT_XML_ALGORITHM *pTransform,
  [in]  CRYPT_XML_DATA_PROVIDER *pProviderIn,
  [out] CRYPT_XML_DATA_PROVIDER *pProviderOut
)
{...}

Parameters

[in] pTransform

A CRYPT_XML_ALGORITHM structure that specifies the transform to apply.

[in] pProviderIn

A pointer to a CRYPT_XML_DATA_PROVIDER structure that specifies the data provider to use as input for the transform.

[out] pProviderOut

A pointer to a CRYPT_XML_DATA_PROVIDER structure to receive the data provider of the transform.

Return value

If the function succeeds, the function returns zero.

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

Remarks

In the transform chain, the output of a transform is the input of the next transform in the chain.

The implementation of the callback function is responsible for calling the provider close function on the input transform to release the input provider.

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

Share via