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

# XGameSaveEnumerateBlobInfoByName

> XGameSaveEnumerateBlobInfoByName

# XGameSaveEnumerateBlobInfoByName

检索 **XGameSaveContainer** 内容的 Blob 信息，仅限于与 *blobNamePrefix* 参数共享前缀的 Blob。

## Syntax

```cpp theme={null}
HRESULT XGameSaveEnumerateBlobInfoByName(  
         XGameSaveContainerHandle container,  
         const char* blobNamePrefix,  
         void* context,  
         XGameSaveBlobInfoCallback* callback  
)  
```

### Parameters

*container*   \_In\_\
类型：XGameSaveContainerHandle

包含要枚举的 Blob 的 **XGameSaveContainer** 句柄。

*blobNamePrefix*   \_In\_opt\_z\_\
类型：char\*

用于筛选检索到的 Blob 的前缀。

*context*   \_In\_opt\_\
类型：void\*

指向调用对象的指针，用于提供上下文。

*callback*   \_In\_\
类型：XGameSaveBlobInfoCallback\*

将为与前缀匹配的每个 Blob 调用的函数，返回 false 以停止枚举。使用此函数迭代 [XGameSaveBlobInfo](/reference/system/xgamesave/structs/xgamesaveblobinfo) 并验证函数调用的成功。

### Return value

类型：HRESULT

函数结果。

## Remarks

<Note>虽然此函数在时间敏感型线程上调用是安全的，但 XGameSaveBlobInfoCallback 可能会导致延迟，具体取决于标题在回调中执行的操作。例如，从回调中复制数据是可以的；但是，执行任何非时间敏感型调用可能会延迟回调的返回。有关详细信息，请参阅[时间敏感型线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)。</Note>

Blob 包含构成容器的实际可检索数据。枚举 Blob 将使你能够查看容器内所有可用的数据。你可以使用 [XGameSaveEnumerateBlobInfo](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo) 枚举容器的所有 Blob，而无需按前缀筛选。

## Requirements

**头文件：** XGameSave.h

**库：** xgameruntime.lib

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

## Conceptual documentation

* [时间敏感型线程](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## See also

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


## Related topics

- [XGameSaveEnumerateBlobInfo](/zh-CN/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo.md)
- [XGameSaveBlobInfoCallback](/zh-CN/reference/system/xgamesave/functions/xgamesaveblobinfocallback.md)
- [XGameSaveBlob](/zh-CN/reference/system/xgamesave/structs/xgamesaveblob.md)
- [XGameSave](/zh-CN/reference/system/xgamesave/xgamesave_members.md)
- [XGameSave API 概述](/zh-CN/build/core-features/common/game-save/xgamesave.md)