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

# Microsoft.Xbox.Wrappers.XGameSave.Provider 참조

> Reference for the Microsoft.Xbox.Wrappers.XGameSave.Provider class, the primary management type for initializing, loading, saving, and querying save containers.

# Microsoft.Xbox.Wrappers.XGameSave.Provider

**XGameSave** 래퍼의 기본 관리 클래스입니다.

## 구문

```cpp theme={null}
class Provider
```

## 메서드

| 메서드 | 설명 |
| - | - |
| [Initialize](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md) | 저장 게임 래퍼를 초기화하고 지정된 사용자에 대한 모든 컨테이너를 동기화합니다. |
| [QueryContainers](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainers.md) | 제공된 이름 접두사와 일치하는 컨테이너 이름의 벡터를 반환합니다. |
| [QueryContainerBlobs](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_querycontainerblobs.md) | 지정된 컨테이너 내 blob(파일)을 식별하는 [BlobInfo](/ko/reference/system/Wrappers/structs/blobinfo.md) 개체의 벡터를 반환합니다. |
| [Load](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_load.md) | 지정된 컨테이너 내의 주어진 blob(파일)에서 데이터를 로드합니다. |
| [Save](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md) | 지정된 컨테이너 내의 지정된 blob(파일)에 데이터를 저장합니다. |
| [GetQuota](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_getquota.md) | 저장 게임 래퍼를 사용하여 저장할 수 있는 데이터 양을 반환합니다. |
| [Delete(std::string&)](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string.md) | 컨테이너와 그 안의 모든 blob(파일)을 삭제합니다. |
| [Delete(std::string&, std::string&)](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_string.md) | 지정된 컨테이너에서 지정된 blob(파일)을 삭제합니다. |
| [Delete(std::string&, BlobNames&)](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_delete_string_blobnames.md) | 지정된 컨테이너에서 하나 이상의 blob(파일)을 삭제합니다. |

## 설명

**XGameSave** 간소화 래퍼는 사용자를 대신하여 데이터를 읽고 쓰고, 게임 세션 간에 유지하며, 여러 디바이스 간 클라우드와 원활하게 동기화할 수 있게 해주는 API 집합입니다. 래퍼 API는 세 가지 범주로 나뉩니다.

**공급자(Provider)**

`gs_provider_t`는 사용자 컨텍스트를 게임 저장에 바인딩하는 핸들입니다. API 상호 작용에 필수적입니다. 각 공급자는 여러 컨테이너를 포함할 수 있으며, 각 공급자의 기본 할당량은 256 MB입니다. 공급자 작업에는 다음이 포함됩니다.

* 할당량 정보
* 컨테이너 관리
* 공급자 메타데이터(Service Configuration ID, UserContext)

**컨테이너(Container)**

컨테이너를 사용하여 데이터를 원자적으로 쓰기, 업데이트, 읽기할 수 있는 그룹으로 논리적으로 상호 연관시킬 수 있습니다. 컨테이너 작업에는 다음이 포함됩니다.

* 컨테이너 정보 및 컨테이너 상태에 대한 쿼리
* 컨테이너 내용에 대한 쿼리
* 컨테이너 데이터에 대한 원자적 업데이트

**Binary large objects(blob)**

blob은 컨테이너 내에 포함된 데이터를 담습니다. blob이 담을 수 있는 최대 데이터 양은 16 MB입니다.

* blob 업데이트 및 삭제 작업은 하나의 작업으로 변경 집합을 커밋할 수 있도록 원자적으로 설계되었습니다. 어느 한 부분이 실패하면 전체 업데이트가 실패합니다.

## 요구 사항

**헤더:** xgamesavewrappers.hpp

**지원되는 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[Microsoft.Xbox.Wrappers.XGameSave.Provider](/ko/reference/system/Wrappers/classes/provider/xgamesave_wrapper_provider)\
[XGameSave 래퍼 멤버](/ko/reference/system/Wrappers/xgamesave_wrapper_members.md)\
[관찰자 디자인 패턴](https://learn.microsoft.com/dotnet/standard/events/observer-design-pattern)


## Related topics

- [Save](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md)
- [Initialize](/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_initialize.md)