Skip to main content

XPackageEnumeratePackages

Finds packages that are already installed, or being installed, and are related to the calling process.

Syntax

Parameters

kind   _In_
Type: XPackageKind
The type of installation packages to be enumerated. scope   _In_
Type: XPackageEnumerationScope
The scope of the installation packages. context   _In_opt_
Type: void*
Context to be passed to the callback specified in the callback parameter. callback   _In_
Type: XPackageEnumerationCallback*
A callback to be called on completion.

Return value

Type: HRESULT HRESULT success or error code.

Remarks

This function isn’t safe to call on a time-sensitive thread. For more information, see Time-sensitive threads.
Use XPackageEnumeratePackages to find packages that are already installed, or being installed, and are related to the calling process. This function can find content packages as well as app packages. It provides details about an installation, through an XPackageDetails structure. If the package is still installing, the installing property is set to true and you can create an installation monitor to let the package’s identifier monitor the progress of installation. There are no generic installation queue notifications; the intent is to use XPackageEnumeratePackages to show and track items in flight. Nor is there an API to stop, start, or cancel an installation. From a game’s perspective, the installation should take care of itself. Errors are automatically retried and are invisible to the game. The output of the API, when called with value XPackageKind::Game depending on the XPackageEnumerationScope value will be: The output of the API, when called with value XPackageKind::Content depending on the XPackageEnumerationScope value will be: Example:

Requirements

Header: XPackage.h Library: xgameruntime.lib Supported platforms: Windows, XBOX One family consoles and XBOX Series consoles

Conceptual documentation

See also

XPackage
Franchise Game Hubs
How to create and use Downloadable Content Packages (DLC) for PC and XBOX One
Last modified on August 20, 2026