IXpsSignatureManager::SavePackageToFile method

Saves the XPS package to a file.

Syntax

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

Parameters

  • fileName [in]
    The name of the file where the XPS package is to be created and saved.

  • securityAttributes [in]
    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.

  • flagsAndAttributes [in]
    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

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Xpsdigitalsignature.h

IDL

XpsDigitalSignature.idl

See also

IXpsSignatureManager

XPS Digital Signature API Errors

XPS Document Errors

XML Paper Specification