영어로 읽기

다음을 통해 공유


XPackageIsPackagedProcess

현재 프로세스에 설치 ID가 있는지 여부를 나타내는 부울을 반환합니다.

구문

bool XPackageIsPackagedProcess(  
)  

매개 변수

없음.

반환 값

형식: bool

프로세스에 설치 ID가 있으면 true가 반환됩니다. 그렇지 않으면 false가 반환됩니다.

설명

게임이 완전히 설치되었는지를 확인할 수 있습니다. 다음 코드 예제는 패키징된 MSICVC 게임 및 느슨한 배포에 적합합니다. 게임이 완전히 설치되면 반환 값(bool *isInstalled)이 true로 설정됩니다.

HRESULT IsPackageCompletelyInstalled(bool *isInstalled)
{
    if (XPackageIsPackagedProcess())
    {
        char id[XPACKAGE_IDENTIFIER_MAX_LENGTH];
        HRESULT hr = XPackageGetCurrentProcessPackageIdentifier(_countof(id), id);
        if (FAILED(hr)) return hr;

        XPackageInstallationMonitorHandle monitor;
        hr = XPackageCreateInstallationMonitor(id, 0, nullptr, 0, nullptr, &monitor);
        if (FAILED(hr)) return hr;

        XPackageInstallationProgress progress;
        XPackageGetInstallationProgress(monitor, &progress);

        *isInstalled = (progress.completed);

        XPackageCloseInstallationMonitorHandle(monitor);
    }
    else
    {
        *isInstalled = true;
    }

    return S_OK;
}

요구 사항

헤더: XPackage.h

라이브러리: xgameruntime.lib

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

참고 항목

패키징 개요
스트리밍 설치 및 지능형 전송
XPackage