Skip to main content

XGameSaveGetContainerInfo

XGameSaveProvider 의 컨테이너에 대한 정보를 검색합니다.

구문

매개 변수

provider   _In_
형식: XGameSaveProviderHandle
원하는 컨테이너를 가진 XGameSaveProvider 핸들입니다. containerName   _In_z_
형식: char*
정보를 검색할 컨테이너의 이름입니다. 발견될 경우 하나의 결과만 반환됩니다. 두 개 이상의 컨테이너를 원하는 경우 XGameSaveEnumerateContainerInfo 또는 XGameSaveEnumerateContainerInfoByName을 사용합니다. context   _In_opt_
형식: void*
컨텍스트를 위한 호출 개체에 대한 포인터입니다. callback   _In_
형식: XGameSaveContainerInfoCallback*
XGameSaveContainerInfo 호출의 결과를 확인하고 데이터를 수집하는 콜백 함수입니다.

반환값

형식: HRESULT 함수 결과

일반적인 오류

  • E_GS_INVALID_CONTAINER_NAME
  • E_GS_USER_CANCELED
  • E_GS_CONTAINER_NOT_IN_SYNC
  • E_GS_CONTAINER_SYNC_FAILED
  • E_GS_HANDLE_EXPIRED

설명

이 함수는 시간에 민감한 스레드에서 호출해도 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
컨테이너는 메타데이터의 컬렉션이며 그 안에 있는 Blob 집합에 대한 참조점입니다. 컨테이너 이름을 미리 알고 있는 경우, 이 API를 사용하여 해당 컨테이너에 대한 정보만 반환할 수 있습니다. 이는 정보가 필요할 때마다 모든 정보를 호출하는 대신 플레이어에 대한 특정 정보를 가져오는 데 유용합니다. XGameSaveContainer 의 구성은 XGameSaveContainerInfo 구조체에서 확인할 수 있습니다.

요구 사항

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

개념 설명서

함께 보기

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