Skip to main content

XPackageEnumeratePackages

尋找已安裝或正在安裝,且與呼叫處理程序相關的套件。

語法

參數

kind   _In_
類型:XPackageKind
要列舉的安裝套件類型。 scope   _In_
類型:XPackageEnumerationScope
安裝套件的範圍。 context   _In_opt_
類型:void*
要傳遞給 callback 參數中所指定回呼的內容。 callback   _In_
類型:XPackageEnumerationCallback*
完成時要呼叫的回呼。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

在時間敏感的執行緒上呼叫此函式並不安全。如需詳細資訊,請參閱時間敏感的執行緒。
使用 XPackageEnumeratePackages 來尋找已安裝或正在安裝,且與呼叫處理程序相關的套件。此函式可以尋找內容套件及應用程式套件。它會透過 XPackageDetails 結構提供安裝的詳細資料。 如果套件仍在安裝中,installing 屬性會設定為 true,您可以建立安裝監視器,讓套件的識別碼監視安裝進度。 沒有一般性的安裝佇列通知;其用意是使用 XPackageEnumeratePackages 來顯示和追蹤進行中的項目。也沒有用來停止、啟動或取消安裝的 API。從遊戲的角度來看,安裝應該會自行處理。錯誤會自動重試,而且對遊戲而言是不可見的。 以 XPackageKind::Game 值呼叫此 API 時,根據 XPackageEnumerationScope 值,輸出將為: 以 XPackageKind::Content 值呼叫此 API 時,根據 XPackageEnumerationScope 值,輸出將為: 範例:

需求

標頭: XPackage.h 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機與 XBOX Series 主機

概念文件

另請參閱

XPackage
系列遊戲中樞
如何為 PC 和 XBOX One 建立及使用可下載內容套件 (DLC)
Last modified on October 6, 2026