IXpsOMPackageWriter：：AddResource 方法 (xpsobjectmodel.h)

在包中创建新的部件资源。

语法

HRESULT AddResource(
  [in] IXpsOMResource *resource
);

参数

[in] resource

将作为包中的新部件添加的部件资源的 IXpsOMResource 接口。 有关可在此参数中传递的资源类型，请参阅备注。

返回值

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

返回代码	说明
S_OK	方法成功。
E_INVALIDARG	与资源引用的资源同名 的资源已添加到 流中，或者不存在包含 由资源引用的资源的关系。 返回 E_INVALIDARG 后，流或文件不再有效， Close 将返回 XPS_E_UNAVAILABLE_PACKAGE。
XPS_E_UNAVAILABLE_PACKAGE	发生严重错误，并且 XPS OM 的内容可能无法恢复。 XPS OM 的某些组件可能仍可用，但仅在验证后才可用。 由于在返回此错误后无法预测 XPS OM 的状态，因此应释放并丢弃 XPS OM 的所有组件。

 

此方法调用 打包 API。 有关打包 API 返回值的信息，请参阅 打包错误。

注解

此方法在与 资源对应的文档包中创建一个新部件，将 资源 的内容添加到新部件，然后关闭新部件。

如果此方法返回错误，则包编写器不再可用。

资源参数必须是下列参数之一：

• 在当前页面或已添加的页面中使用的字体资源的 IXpsOMFontResource 接口。
• 在当前页面或已添加的页面中使用的图像资源的 IXpsOMImageResource 接口。
• 在当前页面或已添加的页面中使用的颜色配置文件资源的 IXpsOMColorProfileResource 接口。
• 在当前页面或已添加的页面中使用的文章片段资源的 IXpsOMStoryFragmentsResource 接口。
• 当前文档中使用的文档结构资源的 IXpsOMDocumentStructureResource 接口或已添加的文档。
• 当前文档中使用的签名块资源的 IXpsOMSignatureBlockResource 接口或已添加的文档。

如果 资源 包含以下项之一，此方法将返回错误：

• 远程资源字典的 IXpsOMRemoteDictionaryResource 接口。
• 打印票证的 IXpsOMPrintTicketResource 接口。
• 缩略图图像的 IXpsOMImageResource 接口。

当 资源 引用的资源与已添加到流或不存在现有关系的资源同名时，此方法将返回错误。

要求

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台	Windows
标头	xpsobjectmodel.h

另请参阅

IXpsOMPackageWriter

IXpsOMPackageWriter3D

IXpsOMResource

打包错误

使用 IXpsOMPackageWriter 接口

XML 纸张规范

XPS 文档错误