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 内容字节式副本的向量。

示例

以下示例代码演示如何使用 加载 方法。

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 类中调用任何其他方法。

要求

头文件:xgamesavewrappers.hpp

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

Microsoft.Xbox.Wrappers.XGameSave.Provider
XGameSave 包装器成员
游戏存档简化包装器