Skip to main content

XGameSaveInitializeProvider

XGameSave プロバイダー ハンドルを提供し、初期化します。

Syntax

Parameters

requestingUser   _In_
型: XUserHandle
XBOX Live ユーザーのハンドル。 configurationId   _In_z_
型: char*
サービス構成 ID (SCID)。 syncOnDemand   _In_
型: bool
true の場合、syncOnDemand は必要な場合にのみサービスからデータをダウンロードします。デバイスがオフラインの場合は機能しません。 true に設定すると、同期進行状況の UI が表示される場合があります。 provider   _Outptr_result_nullonfailure_
型: XGameSaveProviderHandle*
作成する XGameSave プロバイダーへのハンドル。

Return value

型: HRESULT 関数の結果。

Common errors

  • E_GS_USER_CANCELED
  • E_GS_USER_NOT_REGISTERED_IN_SERVICE
  • E_GS_NO_ACCESS
  • E_GS_NO_SERVICE_CONFIGURATION
最も一般的に返されるエラーは、E_OUTOFMEMORY、E_INVALIDARG です。

Remarks

この関数は、時間依存スレッドから呼び出しても安全ではありません。詳細については、Time-sensitive threads を参照してください。
この関数は、他の XGameSave API を使用する前に正常に呼び出す必要があります。この関数は、プレイヤーのゲーム セーブを同期する際にブロックされ、ユーザーに UI が表示される可能性があるため、ゲームの UI スレッドで呼び出すべきではありません。UI スレッドからこの関数を初期化する必要がある場合は、XGameSaveInitializeProviderAsync の呼び出しを検討してください。
XGameSave API を動作させるには、タイトルのタイトル ID とサービス構成 ID (SCID) が
適切に構成されている必要があります。これらの必要な ID の詳細については、Setting Up Sandboxes for XBOX Live Development を参照してください。ゲームは Partner Center で XBOX Live に対して有効化されている必要があります。
SCID とタイトル ID が適切に構成されていない場合、XSaveGame API の呼び出しは次のエラー コードで失敗します。 E_GS_NO_ACCESS - 0x80830002 - タイトルがコンテナー ストレージ領域にアクセスできないため、操作は失敗しました。 この API が syncOnDemand を true に設定して呼び出されると、呼び出し元の観点では同じように動作しますが、残りの API での動作にいくつかの違いが生じます。SyncOnDemand XGameSaveProvider は、必要な場合にのみサービスからデータをダウンロードしますが、この場合、コンテナー操作が遅延する可能性があり、この遅延によって同期進行状況の UX がユーザーに表示されることがあるという欠点もあります。次のいずれかのメソッドを使用すると強制的に同期を発生させることができます。 もう 1 つの欠点は、デバイスがオフラインまたは接続に問題がある場合、コンテナーへのアクセスが不可能であることです。この関数には、XGameSaveInitializeProviderAsync と呼ばれる非同期バージョンがあります。
ゲームは、XGameSaveFiles の使用と XGameSave の使用を混在させることはできません。ゲームは、どちらのクラウド セーブ システムを使用するかを選択する必要があります。ゲームが XGameSaveFiles を使用していて、後で XGameSaveInitializeProvider を呼び出すと、E_GS_PROVIDER_MISMATCH でエラーになります。同様に、ゲームが XGameSave を使用していて、後で XGameSaveFilesGetFolderWithUiAsync を呼び出す場合も、E_GS_PROVIDER_MISMATCH でエラーになります。

Requirements

ヘッダー: XGameSave.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体

Conceptual documentation

See also

XGameSave
XGameSaveInitializeProviderAsync
Debugging Game Saves
最終更新日 2026年8月24日