通过

IXpsOMPackage1：：WriteToFile1 方法 (xpsobjectmodel_1.h)

  • 项目

将 XPS OM 作为指定类型的 XPS 包写入文件。

语法

HRESULT WriteToFile1(
  LPCWSTR               fileName,
  LPSECURITY_ATTRIBUTES securityAttributes,
  DWORD                 flagsAndAttributes,
  BOOL                  optimizeMarkupSize,
  XPS_DOCUMENT_TYPE     documentType
);

参数

fileName

[in， string]要创建的文件的名称。 此参数不得为 NULL。

securityAttributes

[in， unique]SECURITY_ATTRIBUTES 结构，其中包含两个不同但相关的数据成员：

lpSecurityDescriptor：可选的安全描述符

bInheritHandle：一个布尔值，确定返回的句柄是否可以由子进程继承

如果 lpSecurityDescriptor 为 NULL，则将为与返回的句柄关联的文件或设备分配默认安全描述符。

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

flagsAndAttributes

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

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

optimizeMarkupSize

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

TRUE：包编写器将尝试优化标记的最小大小。

FALSE：包编写器不会尝试执行任何优化。

documentType

[in]要写入 outputStream 的 XPS 数据格式。 不能XPS_DOCUMENT_TYPE_UNSPECIFIED此参数的值。

返回值

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

S_OK：方法成功。

E_POINTER：documentType 为 NULL。

E_INVALIDARG：文档类型已指定为XPS_DOCUMENT_TYPE_UNSPECIFIED。

XPS_E_INVALID_CONTENT_TYPE：包中的图像资源属于 documentType 中指定的文档类型不支持的类型。

注解

调用方必须确保包类型支持包中的所有映像资源。 例如，不能在 MSXPS 文档类型中使用 JpegXR 图像，因为它们不兼容。

要求

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

请参阅

IXpsOMPackage1