XPersistentLocalStorageMountForPackage

지정된 패키지의 영구 로컬 스토리지(PLS)를 읽기 전용 디스크로 탑재합니다.

구문

HRESULT XPersistentLocalStorageMountForPackage (   
         const char* packageIdentifier,   
         XPackageMountHandle* mountHandle 
) 

매개 변수

packageIdentifier _In_
형식: char*

PLS가 속한 저장소 패키지를 고유하게 식별하는 문자열입니다. 패키지 식별자에 대한 자세한 내용은 DLC(다운로드 가능한 콘텐츠 관리 및 라이선스)를참조하세요.

mountHandle _Out_writes_to_(pathSize,pathUsed)
형식: XPackageMountHandle

PLS가 탑재된 디스크의 탑재 핸들입니다.

반환 값

형식: HRESULT

성공한 경우 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다. 오류 코드 목록은 오류 코드를 참조하세요. 지정된 타이틀에 대한 PLS가 없어서 함수가 실패하면 FILE_NOT_FOUND로 설정됩니다. 공유 가능한 영구 로컬 스토리지를 사용하도록 설정하지 않은 타이틀의 PLS에 액세스하려고 하여 함수가 실패하면 ACCESS_DENIED를 받습니다.

비고

참고 항목

이 함수는 시간에 민감한 스레드에서 호출하는 것이 안전하지 않습니다. 자세한 내용은 시간에 민감한 스레드를 참조하세요.

타이틀이 공유 가능한 PLS를 지원하려면 MicrosoftGame.config 이와 같이 선언해야 합니다. 공유 가능한 영구 로컬 스토리지에 대한 자세한 내용은 로컬 스토리지에서 확인할 수 있습니다.

참고 항목

타이틀이 PLS를 공유 가능한 것으로 표시하는 경우 게임을 일시 중단하기 전에 PLS에 대한 모든 핸들을 닫고, 그렇지 않으면 게임 일시 중단이 실패하고 게임이 종료되는지 확인해야 합니다.

다음 코드 조각은 다른 타이틀의 공유 가능한 PLS에 액세스하는 예제를 보여 줍니다.

HRESULT MountPersistentLocalStorageForPackage(char* packageIdentifier) 
{      
    XPackageMountHandle* mountHandle; 
    HRESULT hr = XPersistentLocalStorageMountForPackage (packageIdentifier, &mountHandle); 

    if (FAILED(hr)) return hr; 
    size_t pathSize; 
    hr = XGetMountPathSize(mountHandle, &pathSize); 
    if (FAILED(hr)) 
    { 
        XPackageCloseMountHandle(mountHandle); 
        return hr; 
    } 
 
    char* path = new (std::nothrow) char[pathSize]; 
    if (path == nullptr) 
    { 
        XPackageCloseMountHandle (mountHandle); 
        return E_OUTOFMEMORY; 
    } 
 
    hr = XPackageGetMountPath (mountHandle, pathSize, path); 
    if (FAILED(hr)) 
    { 
        XPackageCloseMountHandle(mountHandle); 
        delete[] path; 
        return hr; 
    } 
 
    printf("PLS %s mounted at path %s\n", packageIdentifier, path); 
    delete[] path; 
 
    // Unmounts PLS path if this is the last handle 
    // to it. 
    XPackageCloseMountHandle(mountHandle); 
    return S_OK; 
} 

요구 사항

헤더: XPersistentLocalStorage.h

라이브러리: xgameruntime.lib

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

XPersistentLocalStorage
새로운 MicrosoftGame.config 파일을 사용하는 방법
로컬 저장소