CryptXmlSetHMACSecret function (cryptxml.h)

The CryptXmlSetHMACSecret function sets the HMAC secret on the handle before calling the CryptXmlSign or CryptXmlVerify function.

Syntax

HRESULT CryptXmlSetHMACSecret(
  [in] HCRYPTXML  hSignature,
  [in] const BYTE *pbSecret,
       ULONG      cbSecret
);

Parameters

[in] hSignature

The handle of the XML Signature element.

[in] pbSecret

A pointer to a buffer that contains a block of bytes. The pointer must be valid during the call to the CryptXmlSign or CryptXmlVerify function.

cbSecret

The size, in bytes, of the buffer pointed to by the pbSecret parameter.

Return value

If the function succeeds, the function returns zero.

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

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
Library Cryptxml.lib
DLL Cryptxml.dll