CryptXmlDllGetInterface callback function (cryptxml.h)

Article
02/22/2024

The CryptXmlDllGetInterface function retrieves a pointer to the cryptographic extension functions for the specified algorithm.

Syntax

CryptXmlDllGetInterface Cryptxmldllgetinterface;

HRESULT Cryptxmldllgetinterface(
        DWORD dwFlags,
  [in]  const CRYPT_XML_ALGORITHM_INFO *pMethod,
  [out] CRYPT_XML_CRYPTOGRAPHIC_INTERFACE *pInterface
)
{...}

Parameters

dwFlags

This parameter is reserved and must be set to zero.

[in] pMethod

A pointer to a CRYPT_XML_ALGORITHM_INFO structure to retrieve the interface of.

[out] pInterface

A pointer to a CRYPT_XML_ALGORITHM_INFO structure to receive the interface information.

Return value

If the function succeeds, the function returns zero.

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

Remarks

The cryptographic extensions DLL must export the CryptXmlDllGetInterface entry.

To get the CRYPT_XML_CRYPTOGRAPHIC_INTERFACE table, CryptXml loads the registered cryptographic extensions DLL by using the LoadLibrary function, and then it calls the CryptXmlDllGetInterface function.

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