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

Recupera as informações de blob para o conteúdo de um **XGameSaveContainer**, limitado aos blobs que compartilham um prefixo com o parâmetro *blobNamePrefix*.

## Sintaxe

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

### Parâmetros

*container*   \_In\_\
Tipo: XGameSaveContainerHandle

Identificador para o **XGameSaveContainer** que contém os blobs a serem enumerados.

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

prefixo usado para filtrar os blobs recuperados.

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

Ponteiro para o objeto de chamada para contexto.

*callback*   \_In\_\
Tipo: XGameSaveBlobInfoCallback\*

Função a ser chamada para cada blob que corresponde ao prefixo; retorne false para interromper a enumeração. Use-a para iterar sobre o [XGameSaveBlobInfo](/pt-BR/reference/system/xgamesave/structs/xgamesaveblobinfo) e verificar o êxito da chamada de função.

### Valor retornado

Tipo: HRESULT

Resultado da função.

## Comentários

<Note>Embora seja seguro chamar esta função em uma thread sensível ao tempo, o XGameSaveBlobInfoCallback pode causar atrasos, dependendo do que o título faz dentro do retorno de chamada. Por exemplo, copiar dados do retorno de chamada não tem problema; no entanto, fazer qualquer chamada não sensível ao tempo pode atrasar o retorno do retorno de chamada. Para obter mais informações, consulte [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Os blobs contêm os dados recuperáveis reais que compõem um contêiner. Enumerar os blobs permitirá que você veja todos os dados disponíveis dentro do contêiner. Você pode usar [XGameSaveEnumerateBlobInfo](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo) para enumerar todos os blobs de um contêiner em vez de filtrar por um prefixo.

## Requisitos

**Cabeçalho:** XGameSave.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[XGameSave](/pt-BR/reference/system/xgamesave/xgamesave_members)\
[XGameSaveBlobInfo](/pt-BR/reference/system/xgamesave/structs/xgamesaveblobinfo)\
[XGameSaveEnumerateBlobInfo](/pt-BR/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo)\
[Depuração de salvamentos de jogos](/pt-BR/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveEnumerateBlobInfoByName](/ko/reference/system/xgamesave/functions/xgamesaveenumerateblobinfobyname.md)
- [XGameSaveEnumerateBlobInfo](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo.md)