Skip to main content

XPersistentLocalStorageGetPath

디바이스의 PLS(영구 로컬 스토리지)에 대한 게임별 경로를 반환합니다.

구문

매개 변수

pathSize   _In_
형식: size_t
PLS 경로에 대해 제공된 버퍼의 문자 수입니다. 이 값을 얻으려면 XPersistentLocalStorageGetPathSize를 호출합니다. path   _Out_writes_to_(pathSize,pathUsed)
형식: char
게임이 데이터를 쓸 수 있는 PLS 경로입니다. pathUsed   _Out_opt_
형식: size_t*
제공된 버퍼에 기록된 문자 수입니다.

반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요. pathSize가 PLS 경로 길이보다 작아서 함수가 실패하는 경우, 반환 값은 XBOX 디바이스의 경우 E_FAIL로, PC 디바이스의 경우 **HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)**로 설정됩니다.

설명

이 함수는 시간에 민감한 스레드에서 호출해서는 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.
게임은 스테이징 공간, 게임 내 DLC, 콘텐츠의 온디맨드 생성과 같은 작업을 위해 PLS가 필요할 수 있습니다. 이 공간은 게임 활성화 간에 유지되지만 사용자가 삭제할 수도 있습니다. PLS에 대한 자세한 내용은 로컬 스토리지를 참조하세요. PLS는 디바이스의 제품군에 따라 액세스되고 관리됩니다. XBOX 디바이스의 경우 드라이브 루트에 탑재된 폴더에 대한 액세스를 제공합니다. 해당 폴더에 대해 프로비저닝된 저장 공간의 양은 게임의 MicrosoftGame.config 파일에 지정됩니다. 프로비저닝된 공간은 게임 실행 중에 사용할 수 있으며 항상 존재합니다. 공간을 확보하기 위해 게임이 실행되지 않을 때 사용자는 게임을 제거하지 않고도 프로비저닝된 공간을 삭제할 수 있습니다. 그러나 게임이 실행 중일 때는 스토리지의 가용성이 보장됩니다. XBOX 디바이스에 대해 이 공간을 프로비저닝하려면 MicrosoftGame.config 파일에 해당하는 항목이 있어야 합니다. PC 디바이스의 경우 PC의 로컬 스토리지 폴더 위치에 대한 액세스를 제공하지만 게임을 위해 공간이 특별히 프로비저닝되지 않습니다. 사용자는 게임이 실행 중인 동안에도 해당 공간을 삭제할 수 있습니다. 스토리지 가용성은 보장되지 않으며, 스토리지 공간을 청구하려면 MicrosoftGame.config 파일에 항목이 필요하지 않습니다. 먼저 로컬 스토리지 폴더에서 사용 가능한 공간이 게임의 용도에 충분한지 확인해야 합니다. PLS 경로를 검색하기 위해 이 함수를 호출하기 전에 XPersistentLocalStorageGetPathSize 함수를 호출하여 PLS 경로의 문자 수를 가져온 다음 해당 값을 pathSize 매개 변수에 제공하고 path 매개 변수에 최소한 그만큼의 문자를 할당합니다. pathSize에 지정된 문자 수가 PLS 경로에 포함된 문자 수보다 적으면 오류가 발생합니다. 다음 예제에서는 XPersistentLocalStorageGetPathSizeXPersistentLocalStorageGetPath 함수를 사용하여 게임의 PLS 경로를 가져오는 방법을 보여줍니다.

요구 사항

헤더: XPersistentLocalStorage.h 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

개념 문서

함께 보기

XPersistentLocalStorageGetPathSize
XPersistentLocalStorage
새 MicrosoftGame.config 파일 사용 방법
마지막 수정일 2026년 8월 24일