通过

IXpsOMObjectFactory1：：CreatePackageWriterOnFile1 方法 (xpsobjectmodel_1.h)

  • 项目

打开一个文件，用于将 XPS OM 的内容写入指定类型的 XPS 包。 此方法为 MSXPS 文档或 OpenXPS 文档生成包编写器。

语法

HRESULT CreatePackageWriterOnFile1(
  LPCWSTR                   fileName,
  LPSECURITY_ATTRIBUTES     securityAttributes,
  DWORD                     flagsAndAttributes,
  BOOL                      optimizeMarkupSize,
  XPS_INTERLEAVING          interleaving,
  IOpcPartUri               *documentSequencePartName,
  IXpsOMCoreProperties      *coreProperties,
  IXpsOMImageResource       *packageThumbnail,
  IXpsOMPrintTicketResource *documentSequencePrintTicket,
  IOpcPartUri               *discardControlPartName,
  XPS_DOCUMENT_TYPE         documentType,
  IXpsOMPackageWriter       **packageWriter
);

参数

fileName

[in]要创建的文件的名称。

securityAttributes

[in， unique] SECURITY_ATTRIBUTES 结构，其中包含两个独立但相关的成员：

  • lpSecurityDescriptor：可选的安全描述符
  • bInheritHandle：一个布尔值，用于确定是否可由子进程继承返回的句柄
如果 lpSecurityDescriptor 为 NULL，则会为与返回的句柄关联的文件或设备分配默认安全描述符。

有关 securityAttributes 的详细信息，请参阅 CreateFile。

flagsAndAttributes

[in]指定要创建的文件的设置和属性。 对于大多数文件，可以使用 FILE_ATTRIBUTE_NORMAL 值。

有关此参数的详细信息 ，请参阅 CreateFile 。

optimizeMarkupSize

[in]一个布尔值，指示在将 XPS OM 的内容写入 XPS 包时，是否针对大小优化文档标记。

值 含义
真
 包编写器将尝试优化标记以达到最小大小。
假
 包编写器不会尝试执行任何优化。

interleaving

[in]指定 XPS OM 的内容在写入文件时是否交错。

documentSequencePartName

[in]包含新文件中文档序列的部件名称的 IOpcPartUri 接口。

coreProperties

[in] IXpsOMCoreProperties 接口，其中包含要提供给新文件的核心文档属性。 此参数可以设置为 NULL。

packageThumbnail

[in] IXpsOMImageResource 接口，其中包含要分配给新文件的缩略图图像。 此参数可以设置为 NULL。

documentSequencePrintTicket

[in] IXpsOMPrintTicketResource 接口，其中包含要分配给新文件的包级打印票证。 此参数可以设置为 NULL。

discardControlPartName

[in]包含放弃控件部件名称的 IOpcPartUri 接口。 此参数可以设置为 NULL。

documentType

[in]指定包编写器的文档类型。 不能XPS_DOCUMENT_TYPE_UNSPECIFIED此参数的值。

packageWriter

[out， retval]指向此方法创建的新 IXpsOMPackageWriter 接口的指针。

返回值

可能的值包括但不限于以下内容。 有关此处未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。

S_OK：方法成功，packageWriter 已正确设置。

E_INVALIDARG：文档类型不是有效的 XPS 文档格式。

注解

使用此方法为 MSXPS 文档或 OpenXPS 文档生成包编写器。 在 Windows 7 中发布的 CreatePackageWriterOnFile 仅创建 MSXPS 格式的 XPS 文档文件。

其他引用

其他引用：旧方法说明

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 xpsobjectmodel_1.h
Library 无

请参阅

IXpsOMObjectFactory1