Skip to main content

XGameSaveInitializeProviderAsync

XGameSave Provider 핸들을 비동기적으로 제공하고 초기화합니다.

구문

매개 변수

requestingUser   _In_
형식: XUserHandle
XBOX Live 사용자에 대한 핸들입니다. configurationId   _In_z_
형식: char*
서비스 구성 ID(SCID)입니다. syncOnDemand   _In_
형식: bool
true인 경우 syncOnDemand는 필요한 경우에만 서비스에서 데이터를 다운로드합니다. 장치가 오프라인 상태이면 작동하지 않습니다. true로 설정하면 동기화 진행률 UI가 표시될 수 있습니다. async   _In_
형식: XAsyncBlock*
비동기 호출에 대한 정보를 포함합니다. 여기에는 호출 컨텍스트와 XGameSaveInitializeProviderResult 함수 호출이 포함됩니다.

반환값

형식: HRESULT 함수 결과입니다.

설명

다른 XGameSave API를 사용하기 전에 이 함수가 성공적으로 호출되어야 합니다.
XGameSave API가 작동하려면 타이틀에 타이틀 ID와 서비스 구성 ID(SCID)가
올바르게 구성되어 있어야 합니다. 필수 ID에 대한 자세한 내용은 XBOX Live 개발을 위한 샌드박스 설정을 참조하세요. 게임은 파트너 센터에서 XBOX Live에 대해 활성화되어 있어야 합니다.
SCID와 타이틀 ID를 올바르게 구성하지 않으면 XSaveGame API 호출은 다음 오류 코드와 함께 실패합니다. E_GS_NO_ACCESS - 0x80830002 - 타이틀이 컨테이너 저장소 공간에 액세스할 수 없어 작업이 실패했습니다. 결과 XGameSaveProviderHandleXGameSaveInitializeProviderResult 함수에서 얻어집니다. 이 핸들은 XGameSaveProvider 에 액세스하는 데 사용됩니다. 이 API를 syncOnDemand 를 true로 설정하여 호출하면 호출자 관점에서는 동일하게 동작하지만, API의 나머지 부분에서는 몇 가지 동작 차이가 발생합니다. SyncOnDemand XGameSaveProvider 는 필요한 경우에만 서비스에서 데이터를 다운로드하지만, 이 경우 컨테이너 작업이 지연될 수 있고 이 지연으로 인해 사용자에게 동기화 진행 UX가 표시될 수 있다는 단점도 있습니다. 다음 메서드 중 어느 것이든 사용하면 동기화가 강제로 수행될 수 있습니다. 또 다른 단점은 장치가 오프라인 상태이거나 연결 문제가 있는 경우 컨테이너에 액세스할 수 없다는 것입니다. ##예제
게임은 XGameSaveFiles와 XGameSave의 사용을 함께 사용할 수 없습니다. 게임은 사용할 클라우드 저장 시스템을 선택해야 합니다. 게임이 XGameSaveFiles를 사용하다가 나중에 XGameSaveInitializeProvider를 호출하면 E_GS_PROVIDER_MISMATCH 오류가 발생합니다. 마찬가지로, 게임이 XGameSave를 사용하다가 나중에 XGameSaveFilesGetFolderWithUiAsync를 호출하면 그 역시 E_GS_PROVIDER_MISMATCH 오류가 발생합니다.

요구 사항

헤더: XGameSave.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔

개념 설명서

함께 보기

XGameSave
XGameSaveInitializeProviderResult
XGameSaveInitializeProvider
게임 저장 디버깅
마지막 수정일 2026년 8월 24일