IXpsSigningOptions::GetDigestMethod method (xpsdigitalsignature.h)

Article
02/22/2024

Gets the current digest method.

Syntax

HRESULT GetDigestMethod(
  [out, retval] LPWSTR *digestMethod
);

Parameters

[out, retval] digestMethod

The current digest method.

The following digest methods have been tested in Windows 7:

Return value

If the method succeeds, it returns S_OK; otherwise, it returns an HRESULT error code.

Remarks

The digest method must be set before signing.

When a new instance of this interface is returned by IXpsSignatureManager::CreateSigningOptions, the SignatureMethod and DigestMethod properties are not valid; they must be initialized before the new interface can be used as a parameter of the Sign method.

This method allocates the memory used by the string that is returned in digestMethod. If digestMethod is not NULL, use 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	xpsdigitalsignature.h