IXpsOMPackageWriter：：AddResource 方法 (xpsobjectmodel.h)
在包中创建新的部件资源。
语法
HRESULT AddResource(
[in] IXpsOMResource *resource
);
参数
[in] resource
将作为包中的新部件添加的部件资源的 IXpsOMResource 接口。 有关可在此参数中传递的资源类型，请参阅备注。
返回值
该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
|
与资源引用的资源同名 的资源已添加到 流中，或者不存在包含 由资源引用的资源的关系。
返回 E_INVALIDARG 后，流或文件不再有效， Close 将返回 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 |