Microsoft.Xbox.Wrappers.XGameSave.Provider.Load

指定したコンテナー内にある、指定した BLOB (ファイル) からデータを読み込みます。

構文

BlobData Load(const std::string& containerName,
              const std::string& blobName );

パラメーター

containerName _In_
型: std::string

コンテナーの名前。

blobName _In_
型: std::string

データのロード元の blob の名前。

戻り値

型: BlobData

このメソッドは、blob の内容のバイト単位のコピーを含むベクトルを返します。

例

次のコードは、Load メソッドの使用例を示しています。

using Microsoft::Xbox::Wrappers::GameSave;

Provider provider = new Provider();

if(SUCCEEDED(provider->Initialize(userHandle, mySCID))
{
   std::vector<std::string> containers = provider->QueryContainers("Save slot 1");
   
   if(containers.size() == 1)
   {
      BlobData data = provider->Load("Save_slot_1", "progress");
      
      if(!data.empty())
      {
         // Read the data into the game.
      }
      else
      {
         // Unexpected because there should be
         // only one blob in the container.
      }
   }
}

解説

このメソッドを UI スレッドで呼び出すと、例外がスローされます。

コンテナ名と blob 名に一致するものがない場合、返されるベクトルは空になります。

Provider クラスから他のメソッドを呼び出す前に、Initialize メソッドを呼び出す必要があります。

要件

ヘッダー: xgamesavewrappers.hpp

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

関連項目

Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave ラッパー メンバー
セーブデータのシンプルなラッパー