> ## 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.

# XGameSaveReadBlobDataResult

> XGameSaveReadBlobDataResult

# XGameSaveReadBlobDataResult

擷取 [XGameSaveReadBlobDataAsync](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md) 呼叫的結果。

## 語法

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

### 參數

*async*   \_In\_\
類型：[XAsyncBlock\*](https://docs.xbox.com/zh-TW/reference/system/xasync/structs/xasyncblock.md)

從 [XGameSaveReadBlobDataAsync](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md) 函式傳遞的 AsyncBlock。

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

已配置之 Blob 資料的必要大小。透過 GetAsyncResultSize 擷取。

*blobData*   \_Out\_writes\_bytes\_(blobsSize)\
類型：[XGameSaveBlob\*](https://docs.xbox.com/zh-TW/reference/system/xgamesave/structs/xgamesaveblob.md)

用來包含 Blob 資料的 [XGameSaveBlob](https://docs.xbox.com/zh-TW/reference/system/xgamesave/structs/xgamesaveblob.md) 指標。必須已配置記憶體，以儲存容器中的所有 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](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md) 完成後，於回呼函式中呼叫此函式，以驗證是否成功並擷取 XGameSaveBlob 資料以及 Blob 數目。您可以使用這些值逐一查看容器中的 Blob，以讀取適當的資訊。結果方法通常會與稍後呼叫它們的非同步呼叫內嵌撰寫，但也可以撰寫為個別函式。

如需使用方式，請參閱 [XGameSaveReadBlobDataSync 範例](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md#example)。

## 需求

**標頭：** XGameSave.h

**程式庫：** xgameruntime.lib

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XGameSave](https://docs.xbox.com/zh-TW/reference/system/xgamesave/xgamesave_members.md)\
[XGameSaveReadBlobDataAsync](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md)\
[XGameSaveBlobInfo](https://docs.xbox.com/zh-TW/reference/system/xgamesave/structs/xgamesaveblobinfo.md)\
[偵錯遊戲存檔](https://docs.xbox.com/zh-TW/build/core-features/common/game-save/game-saves-debugging.md)


## Related topics

- [XGameSaveReadBlobDataAsync](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md)
- [XGameSave (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xgamesave/xgamesave_members.md)
- [在 Unity 專案中使用 GDK API 的 C# 包裝函式](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XGameSaveReadBlobData](https://docs.xbox.com/zh-TW/reference/system/xgamesave/functions/xgamesavereadblobdata.md)
- [BlobData](https://docs.xbox.com/zh-TW/reference/system/Wrappers/vectors/blobdata.md)
