게임 저장 오류
가장 일반적인 XGameSave API 오류와 이에 대응하는 방법에 대해 설명합니다.
오류
0x80830001 - E_GS_INVALID_CONTAINER_NAME
컨테이너의 이름이 잘못되었습니다.
컨테이너 이름의 경로 부분(마지막 슬라이드까지 포함한 부분)에 유효한 문자에는 대문자(A-Z), 소문자(a-z), 숫자(0-9), 밑줄(_) 및 슬래시(/)가 포함됩니다. 경로 부분은 비어있을 수 있습니다.
컨테이너 이름의 파일 부분(마지막 슬라이드 이후 모든 부분)에 유효한 문자에는 대문자(A-Z), 소문자(a-z), 숫자(0-9), 밑줄(_) 마침표(.) 및 하이픈(-)이 포함됩니다. 파일 이름은 비어 있거나, 마침표로 끝나거나, 2개의 연속적인 마침표를 포함할 수 없습니다.
0x80830002 - E_GS_NO_ACCESS
Xbox 서비스 구성 ID(SCID)가 서비스에서 올바르게 구성되지 않았습니다.
0x80830003 - E_GS_OUT_OF_LOCAL_STORAGE
장치에 게임 저장을 위한 공간이 부족합니다. 사용자는 장치의 저장 공간을 확보해야 합니다. 이 오류는 게임의 사용자당 저장소 할당량이 초과되어도 발생할 수 있습니다.
0x80830004 - E_GS_USER_CANCELED
사용자가 저장 게임의 다운로드를 취소했습니다.
0x80830005 - E_GS_UPDATE_TOO_BIG
업데이트의 크기가 너무 큽니다. 업데이트의 총 크기가 BLOB의 총 개수에 상관없이 GS_MAX_BLOB_SIZE(16MB)보다 작아야 합니다.
0x80830006 - E_GS_QUOTA_EXCEEDED
이 게임은 게임에 대한 사용자당 할당량을 초과했습니다. 기본적으로 이 할당량은 256MB입니다. 게임이 할당량을 더 늘리기 위한 예외를 요청할 수 있습니다.
0x80830007 - E_GS_PROVIDED_BUFFER_TOO_SMALL
API에 제공되는 버퍼가 너무 작습니다.
0x80830008 - E_GS_BLOB_NOT_FOUND
지정한 BLOB를 찾을 수 없습니다.
0x80830009 - E_GS_NO_SERVICE_CONFIGURATION
연결된 저장소를 사용하도록 타이틀이 올바르게 구성되지 않았습니다. SCID가 잘못되었거나 파트너 센터에서 올바르게 구성되지 않았기 때문일 수 있습니다.
0x8083000A - E_GS_CONTAINER_NOT_IN_SYNC
컨테이너가 아직 동기화되지 않았습니다.
0x8083000B - E_GS_CONTAINER_SYNC_FAILED
컨테이너 동기화에 실패했습니다.
0x8083000C - E_GS_USER_NOT_REGISTERED_IN_SERVICE
이는 MSA가 아직 Xbox 서비스 계정이 아님을 나타냅니다.
0x8083000D - E_GS_HANDLE_EXPIRED
함수에 사용되는 핸들이 만료되어 다시 확보해야 합니다. XGameSave에서 사용하는 핸들 종류는 세 가지가 있습니다. XGameSaveProviderHandle, XGameSaveContainerHandle 및 XGameSaveUpdateHandle입니다. 업데이트를 제출한 후 XGameSaveUpdateHandle을 다시 사용할 수 없습니다. 또한 경기가 중단된 후에는 XGameSaveUpdateHandle이 더 이상 유효하지 않습니다.
0x8083000E - E_GS_ASYNC_FUNCTION_REQUIRED
함수가 시간에 민감한 스레드에 호출됩니다. 이로 인해 게임에 고착 상태가 발생할 수 있습니다. 발신자는 API의 비동기 버전을 사용해야 합니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
0x80831001 - E_GS_TERMINATEDTITLE_STALE_DATA
이 오류는 사용자 지향 XGameSave API를 통해 타이틀에 반환되지 않습니다. 대신 개발자는 게임이 종료될 때 디버그 출력에서 이를 볼 수 있습니다. 이 오류는 게임 저장 공급자가 초기화되었을 때 타이틀에 연결된 저장소 잠금이 없었음을 나타냅니다. 이 문제는 해당 시간에 오프라인 상태이거나 충돌 대화 상자가 표시되었을 때 사용자가 오프라인으로 플레이하도록 선택하는 등의 여러 가지 이유로 발생할 수 있습니다. 게임에 연결된 저장소 잠금이 없었으므로 OS는 게임을 종료하고 다음 시작을 위해 게임을 정상 상태로 전환하기 위해 일시 중단될 때 이 오류를 표시합니다.
0x8083000F - E_GS_PROVIDER_MISMATCH
게임은 XGameSave 및 XGameSaveFiles의 사용량을 혼합하고 일치시키려고 합니다. 이 기능은 지원되지 않습니다. 게임은 게임에 사용하려는 클라우드 저장 시스템을 많이 선택합니다.