通过

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：一个布尔值，用于确定返回的句柄是否可以由子进程继承
如果 lpSecurityDescriptorNULL，则会为与返回的句柄关联的文件或设备分配一个默认的安全描述符。

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

flagsAndAttributes

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

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

optimizeMarkupSize

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

价值 意义
TRUE
 包编写器将尝试优化最小大小的标记。
FALSE
 包编写器不会尝试执行任何优化。

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 应用]
目标平台 窗户
标头 xpsobjectmodel_1.h
库 没有

另请参阅

IXpsOMObjectFactory1