> ## 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. # XGameSave > XGameSave # XGameSave XGameSave API는 게임 관련 상태를 만들고, 로드하고, 저장하고, 관리하는 기능을 제공하도록 설계되었습니다. 이전 구현과의 주요 차이점은 호출자가 API 동작의 스레딩 및 메모리 관리 방식을 제어할 수 있도록 비동기 프로그래밍 모델에 대한 액세스를 제공하는 평면 API를 제공한다는 점입니다. ## 함수 | 함수 | 설명 | | -------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | [XGameSaveBlobInfoCallback](/reference/system/xgamesave/functions/xgamesaveblobinfocallback) | [XGameSaveEnumerateBlobInfo](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo)의 결과를 검색하기 위한 콜백 함수입니다. | | [XGameSaveCloseContainer](/reference/system/xgamesave/functions/xgamesaveclosecontainer) | XGameSaveContainer를 닫습니다. | | [XGameSaveCloseProvider](/reference/system/xgamesave/functions/xgamesavecloseprovider) | XGameSaveProvider가 보유한 리소스를 해제합니다. | | [XGameSaveCloseUpdate](/reference/system/xgamesave/functions/xgamesavecloseupdate) | XGameSaveUpdate를 닫습니다. | | [XGameSaveContainerInfoCallback](/reference/system/xgamesave/functions/xgamesavecontainerinfocallback) | [XGameSaveGetContainerInfo](/reference/system/xgamesave/functions/xgamesavegetcontainerinfo)에 대한 호출을 위한 콜백 함수입니다. | | [XGameSaveCreateContainer](/reference/system/xgamesave/functions/xgamesavecreatecontainer) | XGameSaveContainer 핸들을 만듭니다. | | [XGameSaveCreateUpdate](/reference/system/xgamesave/functions/xgamesavecreateupdate) | 나중에 [XGameSaveSubmitUpdate](/reference/system/xgamesave/functions/xgamesavesubmitupdate)를 호출하여 제출될 업데이트를 만듭니다. | | [XGameSaveDeleteContainer](/reference/system/xgamesave/functions/xgamesavedeletecontainer) | 클라우드 저장소에서 XGameSaveContainer를 삭제합니다. | | [XGameSaveDeleteContainerAsync](/reference/system/xgamesave/functions/xgamesavedeletecontainerasync) | XGameSaveContainer를 비동기적으로 삭제합니다. | | [XGameSaveDeleteContainerResult](/reference/system/xgamesave/functions/xgamesavedeletecontainerresult) | [XGameSaveDeleteContainerAsync](/reference/system/xgamesave/functions/xgamesavedeletecontainerasync) 호출의 결과를 검색합니다. 이 함수를 사용하여 호출의 성공 여부를 확인합니다. | | [XGameSaveEnumerateBlobInfo](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfo) | XGameSaveContainer의 콘텐츠에 대한 Blob 정보를 검색합니다. | | [XGameSaveEnumerateBlobInfoByName](/reference/system/xgamesave/functions/xgamesaveenumerateblobinfobyname) | blobNamePrefix 매개 변수와 접두사가 일치하는 Blob으로 제한된, XGameSaveContainer 콘텐츠에 대한 Blob 정보를 검색합니다. | | [XGameSaveEnumerateContainerInfo](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfo) | XGameSaveProvider에 대한 컨테이너 정보를 검색합니다. | | [XGameSaveEnumerateContainerInfoByName](/reference/system/xgamesave/functions/xgamesaveenumeratecontainerinfobyname) | XGameSaveProvider에 대한 컨테이너 정보를 검색합니다. | | [XGameSaveGetContainerInfo](/reference/system/xgamesave/functions/xgamesavegetcontainerinfo) | XGameSaveProvider의 컨테이너에 대한 정보를 검색합니다. | | [XGameSaveGetRemainingQuota](/reference/system/xgamesave/functions/xgamesavegetremainingquota) | XGameSave API를 사용하여 저장할 수 있는 데이터의 양을 반환합니다. | | [XGameSaveGetRemainingQuotaAsync](/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync) | XGameSave API를 사용하여 저장할 수 있는 데이터의 양을 비동기적으로 반환합니다. | | [XGameSaveGetRemainingQuotaResult](/reference/system/xgamesave/functions/xgamesavegetremainingquotaresult) | [XGameSaveGetRemainingQuotaAsync](/reference/system/xgamesave/functions/xgamesavegetremainingquotaasync) 함수의 결과를 검색합니다. | | [XGameSaveInitializeProvider](/reference/system/xgamesave/functions/xgamesaveinitializeprovider) | XGameSave Provider 핸들을 제공하고 초기화합니다. | | [XGameSaveInitializeProviderAsync](/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync) | XGameSave Provider 핸들을 비동기적으로 제공하고 초기화합니다. | | [XGameSaveInitializeProviderResult](/reference/system/xgamesave/functions/xgamesaveinitializeproviderresult) | [XGameSaveInitializeProviderAsync](/reference/system/xgamesave/functions/xgamesaveinitializeproviderasync) 호출의 결과를 포함합니다. | | [XGameSaveReadBlobData](/reference/system/xgamesave/functions/xgamesavereadblobdata) | 컨테이너에 대한 Blob 데이터를 읽습니다. | | [XGameSaveReadBlobDataAsync](/reference/system/xgamesave/functions/xgamesavereadblobdataasync) | XGameSaveContainer에서 XGameSaveBlob 데이터를 비동기적으로 읽습니다. | | [XGameSaveReadBlobDataResult](/reference/system/xgamesave/functions/xgamesavereadblobdataresult) | [XGameSaveReadBlobDataAsync](/reference/system/xgamesave/functions/xgamesavereadblobdataasync) 호출의 결과를 검색합니다. | | [XGameSaveSubmitBlobDelete](/reference/system/xgamesave/functions/xgamesavesubmitblobdelete) | 게임 저장 XGameSaveUpdate에 삭제 동작을 추가합니다. | | [XGameSaveSubmitBlobWrite](/reference/system/xgamesave/functions/xgamesavesubmitblobwrite) | XGameSaveUpdate에 쓰기 동작을 추가합니다. | | [XGameSaveSubmitUpdate](/reference/system/xgamesave/functions/xgamesavesubmitupdate) | XGameSave 서비스에 업데이트를 제출합니다. 컨테이너 내의 Blob을 업데이트합니다. | | [XGameSaveSubmitUpdateAsync](/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) | XGameSave 서비스에 업데이트를 비동기적으로 제출합니다. 컨테이너 내의 Blob을 업데이트합니다. | | [XGameSaveSubmitUpdateResult](/reference/system/xgamesave/functions/xgamesavesubmitupdateresult) | [XGameSaveSubmitUpdateAsync](/reference/system/xgamesave/functions/xgamesavesubmitupdateasync) 호출의 결과를 검색합니다. | ## 구조체 | 구조체 | 설명 | | ------------------------------------------------------------------------------------ | ---------------------------------------------------- | | [XGameSaveBlob](/reference/system/xgamesave/structs/xgamesaveblob) | XGameSave 저장소의 정보 단위입니다. XGameSaveContainer 내에 있습니다. | | [XGameSaveBlobInfo](/reference/system/xgamesave/structs/xgamesaveblobinfo) | XGameSaveBlob에 대한 정보입니다. | | [XGameSaveContainerInfo](/reference/system/xgamesave/structs/xgamesavecontainerinfo) | XGameSaveContainer에 대한 정보입니다. | ## 오류 코드 XGameSave API에서 다음 오류 코드가 반환될 수 있습니다. 전체 목록은 [오류 코드](/reference/errorcodes)를 참조하세요. 자세한 문제 해결 지침은 [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging)을 참조하세요. | 코드 | 값 | 설명 | | ----------------------------------------- | ---------- | -------------------------------------------------------------------------------- | | 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 호출을 혼합하여 사용하고 있는데, 이는 지원되지 않습니다. | ## 개념 설명서 * [게임 저장 개요](/build/core-features/common/game-save/game-saves-overview) * [XGameSave 가이드](/build/core-features/common/game-save/xgamesave) * [게임 저장 디버깅](/build/core-features/common/game-save/game-saves-debugging) ## 함께 보기 [시스템 API 참조](/reference/system/gc-reference-system-toc) ## Related topics - [Save](/ko/reference/system/Wrappers/classes/provider/methods/xgamesave_wrapper_provider_save.md) - [XGameSave API 개요](/ko/build/core-features/common/game-save/xgamesave.md) - [XGameSaveBlob](/ko/reference/system/xgamesave/structs/xgamesaveblob.md) - [XGameSaveFiles](/ko/reference/system/xgamesavefiles/xgamesavefiles_members.md) - [XGameSave Wrapper reference index and member list](/ko/reference/system/Wrappers/xgamesave_wrapper_members.md)