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

# XGameSaveEnumerateContainerInfoByName

> XGameSaveEnumerateContainerInfoByName

# XGameSaveEnumerateContainerInfoByName

**XGameSaveProvider** 에 대한 컨테이너 정보를 검색합니다. 접두사를 제공하면 함수는 동일한 접두사를 가진 컨테이너만 반환합니다.

## 구문

```cpp theme={null}
HRESULT XGameSaveEnumerateContainerInfoByName(  
         XGameSaveProviderHandle provider,  
         const char* containerNamePrefix,  
         void* context,  
         XGameSaveContainerInfoCallback* callback  
)  
```

### 매개 변수

*provider*   \_In\_\
형식: XGameSaveProviderHandle

[XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo)를 포함하는 **XGameSaveProvider** 입니다.

*containerNamePrefix*   \_In\_opt\_z\_\
형식: char\*

일치하는 컨테이너 이름을 찾기 위해 컨테이너 목록을 검색하는 데 사용할 접두사입니다.

*context*   \_In\_opt\_\
형식: void\*

콜백 함수에 전달될 포인터입니다.

*callback*   \_In\_\
형식: XGameSaveContainerInfoCallback\*

접두사와 일치하는 모든 컨테이너에 대해 실행할 콜백 함수입니다. 열거를 중지하려면 false를 반환합니다. [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo)를 수집하려면 이 함수를 사용합니다.

### 반환값

형식: HRESULT

함수 결과입니다.

## 설명

이 함수를 사용하여 사용자가 사용할 수 있는 컨테이너를 검사합니다. 여기에는 UX에 표시하는 데 필요한 데이터가 포함될 수 있습니다. 이 집합을 열거해도 SyncOnDemand 공급자에 대해 동기화가 발생하지 않으며, 호출자가 [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo)의 needsSync 필드를 통해 실제 동기화 상태를 검사할 수 있습니다. *needsSync* 가 true로 설정된 컨테이너에서 Blob 데이터를 읽거나 업데이트 컨텍스트를 사용하면 동기화가 강제로 수행되며, 다양한 동기화 오류를 반환할 수 있습니다. 열거된 컨테이너에 대해 접두사를 지정할 필요가 없으면 [XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)를 사용할 수 있습니다. [XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)는 사용 가능한 컨테이너의 전체 목록을 반환합니다.

```cpp theme={null}
// Enumerate Container List by prefix, if no prefix is supplied it is 
// the same as calling XGameSaveEnumerateContainerInfo. 
// NOTE: this should be safe to call from a time critical thread 
// but the we are at the mercy of the callback. 
void Sample::_EnumerateContainerInfoByName(const char* prefix) 
{ 
    HRESULT hr = XGameSaveEnumerateContainerInfoByName(_provider, prefix, this, 
        [](const XGameSaveContainerInfo* container, void* context) 
    { 
        auto self = reinterpret_cast<Sample*>(context); 
        self->_UpdateContainerList(container); 
        return true; 
    }); 
    if (FAILED(hr)) 
    { 
        _HandleContainerErrors(prefix, hr); 
    } 
  
} 
```

## 요구 사항

**헤더:** 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)\
[XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo)\
[게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)


## Related topics

- [XGameSaveEnumerateContainerInfo](/ko/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo.md)
- [XGameSaveContainerInfo](/ko/reference/system/xgamesave/structs/xgamesavecontainerinfo.md)
- [XGameSaveContainerInfoCallback](/ko/reference/system/xgamesave/functions/xgamesavecontainerinfocallback.md)
- [XGameSaveGetContainerInfo](/ko/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md)
- [XGameSave API 개요](/ko/build/core-features/common/game-save/xgamesave.md)