Skip to main content

XPackageEnumeratePackages

Busca paquetes que ya están instalados, o que se están instalando, y que están relacionados con el proceso que realiza la llamada.

Sintaxis

Parámetros

kind   _In_
Tipo: XPackageKind
El tipo de paquetes de instalación que se van a enumerar. scope   _In_
Tipo: XPackageEnumerationScope
El ámbito de los paquetes de instalación. context   _In_opt_
Tipo: void*
Contexto que se pasará a la devolución de llamada especificada en el parámetro callback. callback   _In_
Tipo: XPackageEnumerationCallback*
Una devolución de llamada a la que se llamará al finalizar.

Valor devuelto

Tipo: HRESULT HRESULT de éxito o código de error.

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
Use XPackageEnumeratePackages para buscar paquetes que ya están instalados, o que se están instalando, y que están relacionados con el proceso que realiza la llamada. Esta función puede encontrar tanto paquetes de contenido como paquetes de aplicación. Proporciona detalles sobre una instalación a través de una estructura XPackageDetails. Si el paquete todavía se está instalando, la propiedad installing se establece en true y puede crear un monitor de instalación para que el identificador del paquete supervise el progreso de la instalación. No hay notificaciones genéricas de la cola de instalación; la intención es usar XPackageEnumeratePackages para mostrar y hacer un seguimiento de los elementos en curso. Tampoco hay una API para detener, iniciar o cancelar una instalación. Desde la perspectiva de un juego, la instalación debería gestionarse por sí sola. Los errores se reintentan automáticamente y son invisibles para el juego. La salida de la API, cuando se llama con el valor XPackageKind::Game, en función del valor de XPackageEnumerationScope será: La salida de la API, cuando se llama con el valor XPackageKind::Content, en función del valor de XPackageEnumerationScope será: Ejemplo:

Requisitos

Encabezado: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XPackage
Franchise Game Hubs
Cómo crear y usar paquetes de contenido descargable (DLC) para PC y XBOX One
Última modificación el 28 de agosto de 2026