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 傳回值的相關信息，請參閱封裝錯誤。

此方法會在檔套件中建立對應至資源的新元件、將資源的內容新增至新元件，然後關閉新元件。

如果這個方法傳回錯誤，封裝寫入器就無法再使用。

資源參數必須是下列其中一項：

如果資源包含下列其中一項，這個方法會傳回錯誤：

當資源參考與已新增至數據流或沒有現有關聯性之資源同名的資源時，這個方法會傳回錯誤。

需求	值
最低支援的用戶端	適用於 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