IXpsSigningOptions::GetSignatureMethod method

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

See also

IXpsSigningOptions

Cryptography Functions

IOpcSigningOptions

XML Paper Specification