> ## 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]
>
> XBOX では更新はダウンロードされると同時にインストールされるため、この API は意図したとおりに動作しません。
> 更新がゲームのものである場合、ゲームは終了します。
> 更新が DLC のものである場合、その DLC パッケージが現在マウントされていると、ゲームは終了します。
>
> 代わりに [XStoreDownloadAndInstallPackageUpdatesAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md) を使用してください。

指定されたパッケージの更新を、インストールせずにダウンロードします。これにより、ゲームで更新のインストールのタイミングを制御できるため、ユーザーのプレイ中にゲームがシャットダウンされるのを防ぐことができます。

## 構文

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

### パラメーター

*storeContextHandle*   \_In\_\
Type: XStoreContextHandle

[XStoreCreateContext](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstorecreatecontext.md) から返される、ユーザーのストア コンテキスト ハンドル。

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

パッケージ識別子のリスト。
パッケージ識別子は、Microsoft Store パッケージの一意の ID 文字列です。パッケージ識別子の詳細については、「[ダウンロード可能なコンテンツ (DLC) の管理とライセンス](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-dlc.md)」を参照してください。

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

**packageIdentifiers** 内の識別子の数。

*async*   \_Inout\_\
Type: [XAsyncBlock\*](https://docs.xbox.com/ja-jp/reference/system/xasync/structs/xasyncblock.md)

実行中の非同期処理を定義する [XAsyncBlock](https://docs.xbox.com/ja-jp/reference/system/xasync/structs/xasyncblock.md)。[XAsyncBlock](https://docs.xbox.com/ja-jp/reference/system/xasync/structs/xasyncblock.md) は、呼び出しの状態のポーリングと呼び出し結果の取得に使用できます。詳細については、[XAsyncBlock](https://docs.xbox.com/ja-jp/reference/system/xasync/structs/xasyncblock.md) を参照してください。

### 戻り値

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

成功した場合は **S\_OK** を返します。それ以外の場合はエラー コードを返します。

## 解説

この関数は更新をダウンロードするだけで、インストールは行いません。1 回の呼び出しで更新のダウンロードとインストールを行うには、[XStoreDownloadAndInstallPackageUpdatesAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md) 関数を使用します。この関数の結果を取得するには、この関数を呼び出した後に [XStoreDownloadPackageUpdatesResult](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md) を呼び出します。使用例については、[XStoreQueryGameAndDlcPackageUpdatesAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstorequerygameanddlcpackageupdatesasync.md) を参照してください。

この API を実行中のゲームから呼び出すと、ダウンロードは高優先度として扱われ、この API の storeIds パラメーターで指定された順序でキューの先頭に配置されます。

## 要件

**ヘッダー:** XStore.h (XGameRuntime.h に含まれる)

**ライブラリ:** xgameruntime.lib

**サポートされているプラットフォーム:** Windows、XBOX One ファミリ本体、および XBOX Series 本体

## 関連項目

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


## Related topics

- [XStoreDownloadPackageUpdatesResult](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstoredownloadpackageupdatesresult.md)
- [XStore (API の内容)](https://docs.xbox.com/ja-jp/reference/system/xstore/xstore_members.md)
- [Unity プロジェクトでの GDK API 用 C# ラッパーの使用](https://docs.xbox.com/ja-jp/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XStoreDownloadAndInstallPackageUpdatesAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesasync.md)
- [XStoreDownloadAndInstallPackageUpdatesResult](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstoredownloadandinstallpackageupdatesresult.md)