IXpsSigningOptions::GetSignatureMethod method

Article
06/01/2017

Gets the signature method.

Syntax

HRESULT GetSignatureMethod(
  [out, retval] LPWSTR *signatureMethod
);

Parameters

signatureMethod [out, retval]
The signature method that is expressed as a URI. If no signature method has been set, a NULL pointer is returned.

The following signature methods have been tested in Windows 7:

http://www.w3.org/2000/09/xmldsig\#rsa-sha1 [RFC3275]

http://www.w3.org/2001/04/xmldsig-more\#rsa-sha256 [RF4051]

http://www.w3.org/2001/04/xmldsig-more\#rsa-sha384 [RF4051]

http://www.w3.org/2001/04/xmldsig-more\#rsa-sha512 [RF4051]

http://www.w3.org/2001/04/xmldsig-more\#ecdsa-sha1 [RF4051]

http://www.w3.org/2001/04/xmldsig-more\#ecdsa-sha256 [RF4051]

http://www.w3.org/2001/04/xmldsig-more\#ecdsa-sha384 [RF4051]

http://www.w3.org/2001/04/xmldsig-more\#ecdsa-sha512 [RF4051]

http://www.w3.org/2000/09/xmldsig\#dsa-sha1 [RFC3275]

Return value

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

Remarks

A signature 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 signatureMethod. If signatureMethod is not NULL, use the CoTaskMemFree function to free the memory.

Requirements

Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Header	Xpsdigitalsignature.h
IDL	XpsDigitalSignature.idl