> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStoreDownloadPackageUpdatesAsync

> XStoreDownloadPackageUpdatesAsync

# XStoreDownloadPackageUpdatesAsync

> [!NOTE]
>
> Esta API no funciona según lo previsto porque, en XBOX, las actualizaciones se instalan a medida que se descargan.
> Si la actualización es para el juego, el juego finalizará.
> Si la actualización es para DLC, el juego finalizará si el paquete DLC está montado actualmente.
>
> En su lugar, use [XStoreDownloadAndInstallPackageUpdatesAsync](https://docs.xbox.com/es/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md).

Descarga las actualizaciones de los paquetes especificados sin instalarlas. Esto permite que el juego controle cuándo se instalan las actualizaciones para evitar que el juego se cierre mientras el usuario está jugando.

## Sintaxis

```cpp theme={null}
HRESULT XStoreDownloadPackageUpdatesAsync(  
         const XStoreContextHandle storeContextHandle,  
         const char** packageIdentifiers,  
         size_t packageIdentifiersCount,  
         XAsyncBlock* async  
)  
```

### Parámetros

*storeContextHandle*   \_In\_\
Tipo: XStoreContextHandle

El identificador del contexto de la tienda para el usuario devuelto por [XStoreCreateContext](https://docs.xbox.com/es/reference/system/xstore/functions/xstorecreatecontext.md).

*packageIdentifiers*   \_In\_z\_count\_(packageIdentifiersCount)\
Tipo: char\*\*

Lista de identificadores de paquete.
Un identificador de paquete es una cadena de identificador única de un paquete de Microsoft Store. Para obtener más información sobre los identificadores de paquete, consulte [Administración y concesión de licencias de contenido descargable (DLC)](https://docs.xbox.com/es/publishing/xstore-commerce/xstore-dlc.md).

*packageIdentifiersCount*   \_In\_\
Tipo: size\_t

El número de identificadores en **packageIdentifiers**.

*async*   \_Inout\_\
Tipo: [XAsyncBlock\*](https://docs.xbox.com/es/reference/system/xasync/structs/xasyncblock.md)

Un [XAsyncBlock](https://docs.xbox.com/es/reference/system/xasync/structs/xasyncblock.md) que define el trabajo asincrónico que se está realizando. El [XAsyncBlock](https://docs.xbox.com/es/reference/system/xasync/structs/xasyncblock.md) se puede usar para sondear el estado de la llamada y recuperar los resultados de la llamada. Para obtener más información, consulte [XAsyncBlock](https://docs.xbox.com/es/reference/system/xasync/structs/xasyncblock.md).

### Valor devuelto

Tipo: [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Devuelve **S\_OK** si se ejecuta correctamente; de lo contrario, devuelve un código de error.

## Comentarios

Esta función solo descarga una actualización, pero no la instala. Para descargar e instalar una actualización en una sola llamada, use la función [XStoreDownloadAndInstallPackageUpdatesAsync](https://docs.xbox.com/es/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md). Para recuperar el resultado de esta función, llame a [XStoreDownloadPackageUpdatesResult](https://docs.xbox.com/es/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md) después de llamar a esta función. Para ver un ejemplo de uso, consulte [XStoreQueryGameAndDlcPackageUpdatesAsync](https://docs.xbox.com/es/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync.md).

Cuando se llama a esta API desde un juego en ejecución, las descargas se consideran de prioridad alta y se colocan al principio de la cola en el orden en que se especifican en el parámetro storeIds de esta API.

## Requisitos

**Encabezado:** XStore.h (incluido en XGameRuntime.h)

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[XStore](https://docs.xbox.com/es/reference/system/xstore/xstore_members.md)\
[XStoreDownloadPackageUpdatesResult](https://docs.xbox.com/es/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md)\
[XStoreDownloadAndInstallPackageUpdatesAsync](https://docs.xbox.com/es/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md)


## Related topics

- [XStoreDownloadPackageUpdatesResult](https://docs.xbox.com/es/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md)
- [XStore (contenido de la API)](https://docs.xbox.com/es/reference/system/xstore/xstore_members.md)
- [Uso de contenedores de C# para las API del GDK en el proyecto de Unity](https://docs.xbox.com/es/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XStoreDownloadAndInstallPackageUpdatesAsync](https://docs.xbox.com/es/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md)
- [XStoreDownloadAndInstallPackageUpdatesResult](https://docs.xbox.com/es/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesresult.md)
