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