IAppxBundleWriter：：AddPayloadPackage 方法 (appxpackaging.h)

將新的應用程式套件新增至套件組合。

語法

HRESULT AddPayloadPackage(
  [in] LPCWSTR fileName,
  [in] IStream *packageStream
);

[in] fileName

類型： LPCWSTR

承載檔案的名稱。檔名路徑必須相對於封裝的根目錄。

[in] packageStream

類型： IStream*

提供 fileName 內容的 IStream。數據流必須支援讀取、搜尋和統計數據。

類型： HRESULT

如果方法成功，它會 傳回S_OK。否則，它會傳回錯誤碼，其中包含但不限於下表中的錯誤碼。錯誤 OPC 碼，除了OPC_E_DUPLICATE_PART可能會造成。如果方法失敗，套件組合寫入器將會以失敗狀態關閉，而且無法再使用。

傳回碼	Description
E_NOT_VALID_STATE	寫入器已關閉。
HRESULT_FROM_WIN32 (ERROR_INVALID_NAME)	指定的檔名不是有效的檔名，或是磁碟使用量檔案的保留名稱。
OPC_E_DUPLICATE_PART	指定的檔案名已在套件組合中使用。

當 AddPayloadFile 方法成功時，指定的 fileName 內容會寫入封裝，並在套件區塊對應中建立對應的專案。

AddPayloadPackage 會從 packageStream 讀取應用程式套件的內容，並使用指定的 fileName 將內容儲存在套件組合中。

如果下列狀況，AddPayloadPackage 可能會失敗：