Edit

Share via

IXpsSignatureManager::SavePackageToFile method (xpsdigitalsignature.h)

  • Article

Saves the XPS package to a file.

Syntax

HRESULT SavePackageToFile(
  [in] LPCWSTR               fileName,
  [in] LPSECURITY_ATTRIBUTES securityAttributes,
  [in] DWORD                 flagsAndAttributes
);

Parameters

[in] fileName

The name of the file where the XPS package is to be created and saved.

[in] securityAttributes

The SECURITY_ATTRIBUTES structure, which contains two separate but related data members:

  • lpSecurityDescriptor, an optional security descriptor.
  • bInheritHandle, a Boolean value that determines whether the returned handle can be inherited by child processes.
If the lpSecurityDescriptor member of the structure is NULL, the file or device that is associated with the returned handle is assigned a default security descriptor.

For more information about this parameter, see CreateFile.

[in] flagsAndAttributes

The file or device attributes and flags that will be used in file creation. For more information about this parameter, see the description of the dwFlagsAndAttributes parameter in CreateFile.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the table that follows. For return values that are not listed in this table, see XPS Digital Signature API Errors and XPS Document Errors.

Return code Description
S_OK
 The method succeeded.
E_POINTER
 fileName is NULL.
XPS_E_PACKAGE_NOT_OPENED
 An XPS package has not yet been opened in the signature manager.

Remarks

If this method returns an HRESULT value that is not in the list of return values for this method, the signature manager should be released and recreated.

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

See also

IXpsSignatureManager

XML Paper Specification

XPS Digital Signature API Errors

XPS Document Errors