XGameSaveEnumerateContainerInfoByName
XGameSaveProvider 에 대한 컨테이너 정보를 검색합니다. 접두사를 제공하면 함수는 동일한 접두사를 가진 컨테이너만 반환합니다.구문
매개 변수
provider _In_형식: XGameSaveProviderHandle XGameSaveContainerInfo를 포함하는 XGameSaveProvider 입니다. containerNamePrefix _In_opt_z_
형식: char* 일치하는 컨테이너 이름을 찾기 위해 컨테이너 목록을 검색하는 데 사용할 접두사입니다. context _In_opt_
형식: void* 콜백 함수에 전달될 포인터입니다. callback _In_
형식: XGameSaveContainerInfoCallback* 접두사와 일치하는 모든 컨테이너에 대해 실행할 콜백 함수입니다. 열거를 중지하려면 false를 반환합니다. XGameSaveContainerInfo를 수집하려면 이 함수를 사용합니다.
반환값
형식: HRESULT 함수 결과입니다.설명
이 함수를 사용하여 사용자가 사용할 수 있는 컨테이너를 검사합니다. 여기에는 UX에 표시하는 데 필요한 데이터가 포함될 수 있습니다. 이 집합을 열거해도 SyncOnDemand 공급자에 대해 동기화가 발생하지 않으며, 호출자가 XGameSaveContainerInfo의 needsSync 필드를 통해 실제 동기화 상태를 검사할 수 있습니다. needsSync 가 true로 설정된 컨테이너에서 Blob 데이터를 읽거나 업데이트 컨텍스트를 사용하면 동기화가 강제로 수행되며, 다양한 동기화 오류를 반환할 수 있습니다. 열거된 컨테이너에 대해 접두사를 지정할 필요가 없으면 XGameSaveEnumerateContainerInfo를 사용할 수 있습니다. XGameSaveEnumerateContainerInfo는 사용 가능한 컨테이너의 전체 목록을 반환합니다.요구 사항
헤더: XGameSave.h 라이브러리: xgameruntime.lib 지원되는 플랫폼: Windows, XBOX One 계열 콘솔 및 XBOX Series 콘솔개념 설명서
함께 보기
XGameSaveXGameSaveEnumerateContainerInfo
게임 저장 디버깅
