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

Retrieves the blob info for the contents of a **XGameSaveContainer** limited to the blobs which share a prefix with the *blobNamePrefix* parameter.

## Syntax

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

### Parameters

*container*   \_In\_\
Type: XGameSaveContainerHandle

Handle to the **XGameSaveContainer** containing the blobs to be enumerated.

*blobNamePrefix*   \_In\_opt\_z\_\
Type: char\*

prefix used to filter blobs retrieved.

*context*   \_In\_opt\_\
Type: void\*

Pointer to the calling object for context.

*callback*   \_In\_\
Type: XGameSaveBlobInfoCallback\*

Function to be called for every blob that matches the prefix, return false to stop the enumeration. Use this to iterate over the [XGameSaveBlobInfo](/reference/system/xgamesave/structs/xgamesaveblobinfo) and verify success of the function call.

### Return value

Type: HRESULT

Function result.

## Remarks

<Note>While this function is safe to call on a time-sensitive thread, the XGameSaveBlobInfoCallback may cause delays, depending on what the title does within the callback. As an example, copying data from the callback is fine; however, doing any non-time sensitive call can delay the callbacks return. For more information, see [Time-sensitive threads](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Blobs contain the actual retrievable data that makes up a container. Enumerating blobs will allow you to see all of the data available inside of the container. You can use [XGameSaveEnumerateBlobInfo](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo) to enumerate all the blobs of a container instead of filtering by a prefix.

## Requirements

**Header:** XGameSave.h

**Library:** xgameruntime.lib

**Supported platforms:** Windows, XBOX One family consoles and XBOX Series consoles

## Conceptual documentation

* [Time-sensitive threads](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)\
[Debugging Game Saves](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

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