메인 콘텐츠로 건너뛰기
게임 저장 시스템에 사용자를 추가합니다. 필요에 따라 클라우드에서 저장 상태를 다운로드하며, PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback UI 콜백을 트리거할 수 있습니다. 자세한 내용은 PFGameSaveFilesSetUiCallbacks를 참조하세요. PFGameSaveFilesInitialize를 먼저 호출해야 합니다. XBOX 및 Windows 플랫폼에서는 시스템에서 기본 UI를 제공합니다.

구문

매개 변수

localUserHandle PFLocalUserHandle 추가할 로컬 사용자입니다. options PFGameSaveFilesAddUserOptions 사용자를 추가할 때 사용할 옵션입니다. async XAsyncBlock*
Inout
호출 상태를 폴링하고 호출 결과를 검색하기 위한 XAsyncBlock입니다.

반환 값

형식: HRESULT PFGameSaveFilesAddUserWithUiAsync 호출의 결과를 검색하려면 PFGameSaveFilesAddUserWithUiResult를 호출합니다. 이 호출이 완료된 후 PFGameSaveFilesGetFolder를 호출하여 이 사용자의 게임 저장 파일 및 폴더의 루트 폴더를 가져올 수 있습니다. 루트 폴더의 모든 파일과 하위 폴더는 클라우드와 동기화됩니다. 이 함수는 사용자당 한 번만 호출할 수 있으며, 일반적으로 게임의 주 메뉴를 표시하기 전에 호출합니다. 동일한 사용자에 대해 다운로드를 다시 트리거하려면 먼저 PFGameSaveFilesUninitializeAsync를 호출하고 완료될 때까지 기다리세요.

요구 사항

헤더: PFGameSaveFiles.h

참고 항목

PFGameSaveFiles 멤버
마지막 수정일 2026년 10월 6일