> ## 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. # Services C API 개요 - PFGameSaveFiles.h > Services C API 개요 - PFGameSaveFiles.h ## 함수 | 함수 | 설명 | | - | - | | [PFGameSaveFilesActiveDeviceChangedCallback](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesactivedevicechangedcallback) | 활성 디바이스가 변경될 때의 콜백입니다. 이 콜백이 트리거되면 사용자가 다른 디바이스로 이동했다는 의미이므로 이 타이틀은 주 메뉴로 돌아가야 합니다. | | [PFGameSaveFilesAddUserWithUiAsync](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiasync) | 게임 저장 시스템에 사용자를 추가합니다. 필요에 따라 클라우드에서 저장 상태를 다운로드하며 PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback, PFGameSaveFilesUiActiveDeviceContentionCallback, PFGameSaveFilesUiConflictCallback, PFGameSaveFilesUiOutOfStorageCallback UI 콜백이 트리거될 수 있습니다. 자세한 내용은 PFGameSaveFilesSetUiCallbacks를 참조하세요. PFGameSaveFilesInitialize를 먼저 호출해야 합니다. XBOX 및 Windows 플랫폼에서는 시스템에서 기본 UI를 제공합니다. | | [PFGameSaveFilesAddUserWithUiResult](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesadduserwithuiresult) | PFGameSaveFilesAddUserWithUiAsync 호출의 결과를 검색합니다. | | [PFGameSaveFilesGetFolder](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfolder) | 이 사용자의 게임 저장 파일 및 폴더의 루트 폴더를 반환합니다. 이 폴더의 모든 파일과 하위 폴더는 클라우드와 동기화됩니다. 먼저 PFGameSaveFilesAddUserWithUiAsync를 사용하여 사용자를 추가해야 합니다. | | [PFGameSaveFilesGetFolderSize](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetfoldersize) | 이 사용자의 게임 저장 파일 및 폴더의 루트 폴더 크기를 바이트 단위로 반환합니다. 먼저 PFGameSaveFilesAddUserWithUiAsync를 사용하여 사용자를 추가해야 합니다. | | [PFGameSaveFilesGetRemainingQuota](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesgetremainingquota) | PFGameSaveFiles API를 사용하여 저장 데이터를 저장할 수 있는 데이터 양을 바이트 단위로 반환합니다. 할당량을 초과하면 음수가 반환되며 서비스에서 업로드를 차단합니다. | | [PFGameSaveFilesInitialize](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesinitialize) | PlayFab Game Save 라이브러리 인스턴스를 초기화합니다. | | [PFGameSaveFilesIsConnectedToCloud](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesisconnectedtocloud) | 사용자가 클라우드에 연결되어 있는지 여부를 반환합니다. 네트워크 액세스 없이 PFGameSaveFilesAddUserWithUiAsync()를 호출하고 사용자가 PFGameSaveFilesUiSyncFailedCallback에서 PFGameSaveFilesUiSyncFailedUserAction::UseOffline을 선택하면 사용자가 클라우드에서 연결 해제될 수 있습니다. 또한 다른 디바이스가 활성 디바이스가 되면 언제든지 사용자가 클라우드에서 연결 해제될 수 있습니다. 클라우드에서 연결이 해제된 경우 클라우드에 다시 연결을 시도하려면 PFGameSaveFilesAddUserWithUiAsync()를 다시 호출할 수 있습니다. 네트워크가 여전히 오프라인이면 실패 UI가 다시 표시됩니다. 게임 저장을 다시 초기화할 필요는 없지만 원하는 경우 다시 초기화할 수 있습니다. 클라우드에서 연결이 해제된 동안 PFGameSaveFilesUploadWithUiAsync()는 네트워크 액세스가 있더라도 아무 작업도 수행하지 않고 비동기 완료 시 E\_PF\_GAMESAVE\_DISCONNECTED\_FROM\_CLOUD를 반환합니다. | | [PFGameSaveFilesResetCloudAsync](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesresetcloudasync) | 이 사용자의 클라우드 게임 저장 상태를 초기화합니다. 일반적으로 호출할 필요는 없지만 개발 또는 테스트 중에 유용할 수 있습니다. 로컬 게임 저장 데이터는 삭제되거나 변경되지 않습니다. | | [PFGameSaveFilesResetCloudResult](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesresetcloudresult) | PFGameSaveFilesResetCloudAsync 호출의 결과를 검색합니다. | | [PFGameSaveFilesSetActiveDeviceChangedCallback](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetactivedevicechangedcallback) | 활성 디바이스 변경 콜백을 설정합니다. 이 콜백이 트리거되면 사용자가 다른 디바이스로 이동했다는 의미이므로 이 타이틀은 주 메뉴로 돌아가야 합니다. | | [PFGameSaveFilesSetSaveDescriptionAsync](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionasync) | 보류 중인 게임 저장의 짧은 저장 설명을 설정합니다. 이 설명은 충돌 또는 활성 디바이스 경합 UI에 표시될 수 있습니다. | | [PFGameSaveFilesSetSaveDescriptionResult](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionresult) | PFGameSaveFilesSetSaveDescriptionAsync 호출의 결과를 검색합니다. | | [PFGameSaveFilesUninitializeAsync](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuninitializeasync) | PlayFab Game Save 라이브러리 인스턴스를 정리합니다. | | [PFGameSaveFilesUninitializeResult](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuninitializeresult) | PFGameSaveFilesUninitializeAsync 호출의 결과를 검색합니다. | | [PFGameSaveFilesUploadWithUiAsync](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiasync) | PFGameSaveFilesGetFolder()가 반환한 폴더의 모든 파일과 폴더를 업로드합니다. 사용자를 먼저 추가해야 합니다. Windows가 아닌 플랫폼에서는 게임과 동일한 프로세스에서 업로드가 수행되며 PFGameSaveFilesUiProgressCallback, PFGameSaveFilesUiSyncFailedCallback UI 콜백이 트리거될 수 있습니다. XBOX 및 Windows 플랫폼에서는 업로드가 프로세스 외부에서 수행되며 시스템에서 기본 UI를 제공합니다. XBOX 및 Windows 플랫폼에서는 게임이 실행 중이 아닐 때 업로드가 자동으로 수행되므로 이 API 호출은 선택 사항입니다. | | [PFGameSaveFilesUploadWithUiResult](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesuploadwithuiresult) | PFGameSaveFilesUploadWithUiAsync 호출의 결과를 검색합니다. | ## Related topics - [Services C API 개요 - PFGameSaveFilesTypes.h](/ko/services/playfab/api-references/c/pfgamesavefilestypes/pfgamesavefilestypes_members.md) - [Services C API 개요 - PFGameSaveFilesUi.h](/ko/services/playfab/api-references/c/pfgamesavefilesui/pfgamesavefilesui_members.md) - [XGameSaveFiles API 개요](/ko/build/core-features/common/game-save/xgamesavefiles.md) - [PFGameSaveFilesInitialize](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilesinitialize.md) - [PFGameSaveFilesSetSaveDescriptionAsync](/ko/services/playfab/api-references/c/pfgamesavefiles/functions/pfgamesavefilessetsavedescriptionasync.md)