XGameSaveCreateContainer
XGameSaveContainer 핸들을 만듭니다.
구문
HRESULT XGameSaveCreateContainer(
XGameSaveProviderHandle provider,
const char* containerName,
XGameSaveContainerHandle* containerContext
)
매개 변수
provider _In_
형식: XGameSaveProviderHandle
컨테이너를 만드는 XGameSaveProvider에 대한 핸들입니다.
containerName _In_z_
형식: char*
만들려는 컨테이너의 이름입니다.
컨테이너 이름의 경로 부분(마지막 슬라이드까지 포함한 부분)에 유효한 문자에는 대문자(A-Z), 소문자(a-z), 숫자(0-9), 밑줄(_) 및 슬래시(/)가 포함됩니다. 경로 부분은 비어있을 수 있습니다.
컨테이너 이름의 파일 부분(마지막 슬라이드 이후 모든 부분)에 유효한 문자에는 대문자(A-Z), 소문자(a-z), 숫자(0-9), 밑줄(_) 마침표(.) 및 하이픈(-)이 포함됩니다. 파일 이름은 비어 있거나, 마침표로 끝나거나, 2개의 연속적인 마침표를 포함할 수 없습니다.
컨테이너 이름의 최대 길이는 256자입니다.
containerContext _Outptr_result_nullonfailure_
형식: XGameSaveContainerHandle*
이 함수 호출로 반환할 XGameSaveContainer에 대한 핸들입니다.
반환 값
형식: HRESULT
함수 결과입니다. containerName이 유효하지 않으면 함수는 _GS_INVALID_CONTAINER_NAME(0x80830001)을 반환합니다.
비고
참고 항목
이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
참고 항목
XGameSave API를 사용하려면 타이틀의 타이틀 ID와 SCID(서비스 구성 ID)가 제대로 구성되어 있어야 합니다. 이러한 필수 ID에 대한 자세한 내용은 Xbox Live 개발을 위한 샌드박스 설정을 참조하세요. 게임이 파트너 센터에서 Xbox Live에 대해 활성화되어 있어야 합니다.
SCID 및 타이틀 ID를 올바르게 구성하지 않으면 XSaveGame API 호출이 실패하고 다음 오류 코드가 표시됩니다.
E_GS_NO_ACCESS - 0x80830002 - 타이틀에 컨테이너 저장소 공간에 대한 액세스 권한이 없기 때문에 작업이 실패했습니다.
XGameSaveCreateContainer는 컨테이너를 만들고 이름을 식별자로 사용하여 이전에 만든 컨테이너에 액세스하기 위해 사용됩니다. 게임 저장 컨테이너는 XGameSaveBlobs 형식으로 플레이어에 대한 정보를 포함합니다. Blob는 플레이어와 연결된 특정 데이터이며, 이 데이터에는 blob 데이터를 읽는 데 도움이 되는 다른 정보와 함께 이름과 값이 포함됩니다. XGameSaveContainerInfo 구조에서 XGameSaveContainer의 구성을 찾을 수 있습니다.
참고 항목
컨테이너에 대해 XGameSaveSubmitUpdate 또는 XGameSaveSubmitUpdateAsync 가 호출될 때까지 컨테이너가 종료되지 않습니다. 업데이트 API가 호출될 때까지 컨테이너는 XGameSaveEnumerateContainerInfoByName의 결과에 제공되지 않습니다.
요구 사항
헤더: XGameSave.h
라이브러리: xgameruntime.lib
지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔