XPackageGetMountPath

탑재된 설치에 대한 경로를 가져옵니다.

구문

HRESULT XPackageGetMountPath(  
         XPackageMountHandle mount,  
         size_t pathSize,  
         char* path  
)  

매개 변수

mount _In_
형식: XPackageMountHandle

탑재에 대한 핸들입니다.

pathSize _In_
형식: size_t

경로 매개 변수의 크기(바이트)입니다. 필요한 경로 크기를 확인하려면 XPackageGetMountPathSize를 사용합니다.

path _Out_writes_(pathSize)
형식: char*

탑재된 설치에 대한 경로입니다.

반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

설명

참고 항목

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

XPackageGetMountPath는 지정된 패키지 식별자를 탑재하고 탑재 핸들을 반환합니다. 이 작업은 몇 초 정도 걸릴 수 있습니다. 패키지 식별자에 대한 자세한 내용은 DLC(다운로드 가능한 콘텐츠 관리 및 라이선스)를참조하세요.

XPackageGetMountPath 및 XPackageGetMountPathSize는 함께 패키지의 콘텐츠에 대한 파일 경로를 반환하는 데 사용됩니다.

콘텐츠 패키지만 탑재할 수 있습니다. 다른 게임을 탑재하려고 시도하면 E_ACCESS_DENIED가 발생합니다.

다음 코드 예제에서는 패키지가 일반적으로 탑재되는 방법을 보여줍니다.

HRESULT MountDlc(char* dlcIdentifier)
{
    XPackageMountHandle mountHandle;
    HRESULT hr = XPackageMount(dlcIdentifier, &mountHandle);
    if (FAILED(hr)) return hr;

    size_t pathSize;
    hr = XPackageGetMountPathSize(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("Dlc %s mounted at path %s\n", dlcIdentifier, path);

    delete[] path;

    // Unmounts DLC path if this is the last handle
    // to it.
    XPackageCloseMountHandle(mountHandle);
    return S_OK;
}

요구 사항

헤더: XPackage.h

라이브러리: xgameruntime.lib

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

참고 항목

XPackage
PC 및 Xbox One용 DLC(다운로드 가능한 콘텐츠) 패키지를 만들고 사용하는 방법XPackageGetMountPathSize