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

# XGameSaveReadBlobDataResult

> XGameSaveReadBlobDataResult

# XGameSaveReadBlobDataResult

检索 [XGameSaveReadBlobDataAsync](/reference/system/xgamesave/functions/xgamesavereadblobdataasync) 调用的结果。

## 语法

```cpp theme={null}
HRESULT XGameSaveReadBlobDataResult(  
         XAsyncBlock* async,  
         size_t blobsSize,  
         XGameSaveBlob* blobData,  
         uint32_t* countOfBlobs  
)  
```

### 参数

*async*   \_In\_\
类型：[XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

从 [XGameSaveReadBlobDataAsync](/reference/system/xgamesave/functions/xgamesavereadblobdataasync) 函数传入的 AsyncBlock。

*blobsSize*   \_In\_\
类型：size\_t

已分配的 Blob 数据的所需大小。通过 GetAsyncResultSize 检索。

*blobData*   \_Out\_writes\_bytes\_(blobsSize)\
类型：[XGameSaveBlob\*](/reference/system/xgamesave/structs/xgamesaveblob)

用于包含 Blob 数据的 [XGameSaveBlob](/reference/system/xgamesave/structs/xgamesaveblob) 指针。必须分配足够的内存来存储容器中的所有 Blob。

*countOfBlobs*   \_Out\_\
类型：uint32\_t\*

结果中返回的 Blob 数量。

### 返回值

类型：HRESULT

函数结果。

#### 常见错误

* E\_GS\_INVALID\_CONTAINER\_NAME
* E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL
* E\_GS\_BLOB\_NOT\_FOUND
* E\_GS\_CONTAINER\_NOT\_IN\_SYNC
* E\_GS\_CONTAINER\_SYNC\_FAILED
* E\_GS\_HANDLE\_EXPIRED

## 备注

在 [XGameSaveReadBlobDataAsync](/reference/system/xgamesave/functions/xgamesavereadblobdataasync) 完成后，将此函数作为回调函数的一部分进行调用，以验证是否成功并检索 XGameSaveBlob 数据以及 Blob 数量。你可以使用这些值来迭代容器中的 Blob 以读取相应的信息。结果方法通常与异步调用内联编写（异步调用稍后会调用它们），但也可以编写为单独的函数。

有关用法，请参阅 [XGameSaveReadBlobDataSync 示例](/reference/system/xgamesave/functions/xgamesavereadblobdataasync#example)。

## 要求

**标头：** XGameSave.h

**库：** xgameruntime.lib

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[XGameSave](/reference/system/xgamesave/xgamesave_members)\
[XGameSaveReadBlobDataAsync](/reference/system/xgamesave/functions/xgamesavereadblobdataasync)\
[XGameSaveBlobInfo](/reference/system/xgamesave/structs/xgamesaveblobinfo)\
[调试游戏保存](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveReadBlobDataAsync](/zh-CN/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md)
- [XGameSave](/zh-CN/reference/system/xgamesave/xgamesave_members.md)
- [面向 GDK 的 Unity C# API 包装器](/zh-CN/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XGameSaveReadBlobData](/zh-CN/reference/system/xgamesave/functions/xgamesavereadblobdata.md)
- [XGameSaveBlob](/zh-CN/reference/system/xgamesave/structs/xgamesaveblob.md)