IXpsSignatureManager::SavePackageToFile method (xpsdigitalsignature.h)

Article
02/22/2024

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