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

*blobNamePrefix* 매개 변수와 접두사가 일치하는 Blob으로 제한된, **XGameSaveContainer** 콘텐츠에 대한 Blob 정보를 검색합니다.

## 구문

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

### 매개 변수

*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)를 반복하고 함수 호출의 성공 여부를 확인합니다.

### 반환값

형식: HRESULT

함수 결과입니다.

## 설명

<Note>이 함수는 시간에 민감한 스레드에서 호출하기에 안전하지만, XGameSaveBlobInfoCallback은 타이틀이 콜백 내에서 수행하는 작업에 따라 지연을 일으킬 수 있습니다. 예를 들어, 콜백에서 데이터를 복사하는 것은 괜찮지만, 시간에 민감하지 않은 호출을 수행하면 콜백 반환이 지연될 수 있습니다. 자세한 내용은 [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)를 참조하세요.</Note>

Blob에는 컨테이너를 구성하는 실제로 검색 가능한 데이터가 포함되어 있습니다. Blob을 열거하면 컨테이너 내부에서 사용 가능한 모든 데이터를 볼 수 있습니다. 접두사로 필터링하는 대신 컨테이너의 모든 Blob을 열거하려면 [XGameSaveEnumerateBlobInfo](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo)를 사용하면 됩니다.

## 요구 사항

**헤더:** XGameSave.h

**라이브러리:** xgameruntime.lib

**지원되는 플랫폼:** Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

## 개념 설명서

* [시간에 민감한 스레드](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## 함께 보기

[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](/ko/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo.md)
- [XGameSaveBlobInfoCallback](/ko/reference/system/xgamesave/functions/xgamesaveblobinfocallback.md)
- [XGameSaveBlob](/ko/reference/system/xgamesave/structs/xgamesaveblob.md)
- [XGameSave](/ko/reference/system/xgamesave/xgamesave_members.md)
- [XGameSave API 개요](/ko/build/core-features/common/game-save/xgamesave.md)