> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameSave (API 콘텐츠)

> XGameSave

# XGameSave

XGameSave API는 게임 관련 상태를 만들고, 로드하고, 저장하고, 관리하는 기능을 제공하도록 설계되었습니다. 이전 구현과의 주요 차이점은 호출자가 API 동작의 스레딩 및 메모리 관리 방식을 제어할 수 있도록 비동기 프로그래밍 모델에 대한 액세스를 제공하는 평면 API를 제공한다는 점입니다.

## 함수

| 함수 | 설명 |
| - | - |
| [XGameSaveBlobInfoCallback](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveblobinfocallback.md) | [XGameSaveEnumerateBlobInfo](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo.md)의 결과를 검색하기 위한 콜백 함수입니다. |
| [XGameSaveCloseContainer](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveclosecontainer.md) | XGameSaveContainer를 닫습니다. |
| [XGameSaveCloseProvider](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavecloseprovider.md) | XGameSaveProvider가 보유한 리소스를 해제합니다. |
| [XGameSaveCloseUpdate](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavecloseupdate.md) | XGameSaveUpdate를 닫습니다. |
| [XGameSaveContainerInfoCallback](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavecontainerinfocallback.md) | [XGameSaveGetContainerInfo](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md)에 대한 호출을 위한 콜백 함수입니다. |
| [XGameSaveCreateContainer](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavecreatecontainer.md) | XGameSaveContainer 핸들을 만듭니다. |
| [XGameSaveCreateUpdate](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavecreateupdate.md) | 나중에 [XGameSaveSubmitUpdate](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavesubmitupdate.md)를 호출하여 제출될 업데이트를 만듭니다. |
| [XGameSaveDeleteContainer](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavedeletecontainer.md) | 클라우드 저장소에서 XGameSaveContainer를 삭제합니다. |
| [XGameSaveDeleteContainerAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavedeletecontainerasync.md) | XGameSaveContainer를 비동기적으로 삭제합니다. |
| [XGameSaveDeleteContainerResult](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavedeletecontainerresult.md) | [XGameSaveDeleteContainerAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavedeletecontainerasync.md) 호출의 결과를 검색합니다. 이 함수를 사용하여 호출의 성공 여부를 확인합니다. |
| [XGameSaveEnumerateBlobInfo](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo.md) | XGameSaveContainer의 콘텐츠에 대한 Blob 정보를 검색합니다. |
| [XGameSaveEnumerateBlobInfoByName](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveenumerateblobinfobyname.md) | blobNamePrefix 매개 변수와 접두사가 일치하는 Blob으로 제한된, XGameSaveContainer 콘텐츠에 대한 Blob 정보를 검색합니다. |
| [XGameSaveEnumerateContainerInfo](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo.md) | XGameSaveProvider에 대한 컨테이너 정보를 검색합니다. |
| [XGameSaveEnumerateContainerInfoByName](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname.md) | XGameSaveProvider에 대한 컨테이너 정보를 검색합니다. |
| [XGameSaveGetContainerInfo](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavegetcontainerinfo.md) | XGameSaveProvider의 컨테이너에 대한 정보를 검색합니다. |
| [XGameSaveGetRemainingQuota](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavegetremainingquota.md) | XGameSave API를 사용하여 저장할 수 있는 데이터의 양을 반환합니다. |
| [XGameSaveGetRemainingQuotaAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md) | XGameSave API를 사용하여 저장할 수 있는 데이터의 양을 비동기적으로 반환합니다. |
| [XGameSaveGetRemainingQuotaResult](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult.md) | [XGameSaveGetRemainingQuotaAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync.md) 함수의 결과를 검색합니다. |
| [XGameSaveInitializeProvider](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveinitializeprovider.md) | XGameSave Provider 핸들을 제공하고 초기화합니다. |
| [XGameSaveInitializeProviderAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync.md) | XGameSave Provider 핸들을 비동기적으로 제공하고 초기화합니다. |
| [XGameSaveInitializeProviderResult](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveinitializeproviderresult.md) | [XGameSaveInitializeProviderAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync.md) 호출의 결과를 포함합니다. |
| [XGameSaveReadBlobData](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavereadblobdata.md) | 컨테이너에 대한 Blob 데이터를 읽습니다. |
| [XGameSaveReadBlobDataAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md) | XGameSaveContainer에서 XGameSaveBlob 데이터를 비동기적으로 읽습니다. |
| [XGameSaveReadBlobDataResult](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavereadblobdataresult.md) | [XGameSaveReadBlobDataAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavereadblobdataasync.md) 호출의 결과를 검색합니다. |
| [XGameSaveSubmitBlobDelete](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavesubmitblobdelete.md) | 게임 저장 XGameSaveUpdate에 삭제 동작을 추가합니다. |
| [XGameSaveSubmitBlobWrite](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavesubmitblobwrite.md) | XGameSaveUpdate에 쓰기 동작을 추가합니다. |
| [XGameSaveSubmitUpdate](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavesubmitupdate.md) | XGameSave 서비스에 업데이트를 제출합니다. 컨테이너 내의 Blob을 업데이트합니다. |
| [XGameSaveSubmitUpdateAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavesubmitupdateasync.md) | XGameSave 서비스에 업데이트를 비동기적으로 제출합니다. 컨테이너 내의 Blob을 업데이트합니다. |
| [XGameSaveSubmitUpdateResult](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavesubmitupdateresult.md) | [XGameSaveSubmitUpdateAsync](https://docs.xbox.com/ko/reference/system/xgamesave/functions/xgamesavesubmitupdateasync.md) 호출의 결과를 검색합니다. |

## 구조체

| 구조체 | 설명 |
| - | - |
| [XGameSaveBlob](https://docs.xbox.com/ko/reference/system/xgamesave/structs/xgamesaveblob.md) | XGameSave 저장소의 정보 단위입니다. XGameSaveContainer 내에 있습니다. |
| [XGameSaveBlobInfo](https://docs.xbox.com/ko/reference/system/xgamesave/structs/xgamesaveblobinfo.md) | XGameSaveBlob에 대한 정보입니다. |
| [XGameSaveContainerInfo](https://docs.xbox.com/ko/reference/system/xgamesave/structs/xgamesavecontainerinfo.md) | XGameSaveContainer에 대한 정보입니다. |

## 오류 코드

XGameSave API에서 다음 오류 코드가 반환될 수 있습니다. 전체 목록은 [오류 코드](https://docs.xbox.com/ko/reference/errorcodes.md)를 참조하세요. 자세한 문제 해결 지침은 [게임 저장 디버깅](https://docs.xbox.com/ko/build/core-features/common/game-save/game-saves-debugging.md)을 참조하세요.

| 코드 | 값 | 설명 |
| - | - | - |
| E\_GS\_INVALID\_CONTAINER\_NAME | 0x80830001 | 컨테이너의 이름이 유효하지 않습니다. 유효한 컨테이너 이름 문자에는 대/소문자, 숫자, 밑줄, 슬래시가 포함됩니다. |
| E\_GS\_NO\_ACCESS | 0x80830002 | 타이틀이 컨테이너 저장소 공간에 액세스할 수 없어 작업이 실패했습니다. SCID와 TitleId가 올바르게 구성되었는지 확인합니다. |
| E\_GS\_OUT\_OF\_LOCAL\_STORAGE | 0x80830003 | 게임을 저장할 저장 용량이 장치에 부족합니다. |
| E\_GS\_USER\_CANCELED | 0x80830004 | 사용자가 저장 게임 다운로드를 취소했습니다. |
| E\_GS\_UPDATE\_TOO\_BIG | 0x80830005 | 저장 업데이트의 크기가 너무 큽니다. XGameSave 업데이트의 전체 크기는 GS\_MAX\_BLOB\_SIZE(16MB)보다 작아야 합니다. |
| E\_GS\_QUOTA\_EXCEEDED | 0x80830006 | 이 사용자에 대한 타이틀의 저장 할당량이 초과되었습니다. |
| E\_GS\_PROVIDED\_BUFFER\_TOO\_SMALL | 0x80830007 | API에 제공된 버퍼가 너무 작습니다. |
| E\_GS\_BLOB\_NOT\_FOUND | 0x80830008 | 지정된 Blob을 찾을 수 없습니다. |
| E\_GS\_NO\_SERVICE\_CONFIGURATION | 0x80830009 | 연결된 저장소에 대해 타이틀이 올바르게 구성되어 있지 않습니다. SCID가 올바른지, 타이틀이 파트너 센터에 구성되어 있는지 확인합니다. |
| E\_GS\_CONTAINER\_NOT\_IN\_SYNC | 0x8083000A | 컨테이너가 아직 동기화되지 않았습니다. 업데이트를 제출하기 전에 XGameSave 컨테이너가 동기화되어 있는지 확인합니다. |
| E\_GS\_CONTAINER\_SYNC\_FAILED | 0x8083000B | 컨테이너 동기화에 실패했습니다. |
| E\_GS\_USER\_NOT\_REGISTERED\_IN\_SERVICE | 0x8083000C | 사용자의 MSA가 아직 XBOX 서비스 계정이 아닙니다. |
| E\_GS\_HANDLE\_EXPIRED | 0x8083000D | 함수에서 사용하는 핸들이 만료되었으므로 다시 획득해야 합니다. |
| E\_GS\_ASYNC\_FUNCTION\_REQUIRED | 0x8083000E | 이 동기 함수는 시간에 민감한 스레드에서 호출되고 있어 교착 상태의 위험이 있습니다. 대신 비동기 구현을 사용합니다. |
| E\_GS\_PROVIDER\_MISMATCH | 0x8083000F | 게임이 XGameSave와 XGameSaveFiles 호출을 혼합하여 사용하고 있는데, 이는 지원되지 않습니다. |

## 개념 설명서

* [게임 저장 개요](https://docs.xbox.com/ko/build/core-features/common/game-save/game-saves-overview.md)
* [XGameSave 가이드](https://docs.xbox.com/ko/build/core-features/common/game-save/xgamesave.md)
* [게임 저장 디버깅](https://docs.xbox.com/ko/build/core-features/common/game-save/game-saves-debugging.md)

## 함께 보기

[시스템 API 참조](https://docs.xbox.com/ko/reference/system/gc-reference-system-toc.md)


## Related topics

- [XGameSave API 개요](https://docs.xbox.com/ko/build/core-features/common/game-save/xgamesave.md)
- [게임 저장 디버깅](https://docs.xbox.com/ko/build/core-features/common/game-save/game-saves-debugging.md)
- [게임 저장 스토리지 시스템](https://docs.xbox.com/ko/build/core-features/common/game-save/game-saves-storage-systems.md)
- [게임 저장 도구](https://docs.xbox.com/ko/build/core-features/common/game-save/game-saves-tools.md)
- [XGameSave Wrapper 참조 (API 콘텐츠)](https://docs.xbox.com/ko/reference/system/Wrappers/xgamesave_wrapper_members.md)