IOpcSignatureReference::GetDigestValue method (msopc.h)

Gets the digest value that is calculated for the referenced XML element when the element is signed.

Syntax

HRESULT GetDigestValue(
  [out] UINT8  **digestValue,
  [out] UINT32 *count
);

Parameters

[out] digestValue

A pointer to a buffer that contains the digest value calculated using the specified digest method when the referenced XML element is signed.

[out] count

The size of the digestValue buffer.

If the referenced XML element has not been signed yet, count is 0.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_POINTER
At least one of the digestValue, and count parameters is NULL.

Remarks

This method allocates memory used by the buffer returned in digestValue. If the method succeeds, call the CoTaskMemFree function to free the memory.

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 msopc.h

See also

Core Packaging Interfaces

Getting Started with the Packaging API

IOpcSignatureReference

Overviews

Packaging API Programming Guide

Packaging API Reference

Packaging API Samples

Packaging Digital Signature Interfaces

Packaging Interfaces

Reference