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 Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | xpsobjectmodel.h |