XStoreDownloadAndInstallPackageUpdatesAsync

지정된 Microsoft Store 패키지의 업데이트를 다운로드하고 설치합니다.

구문

HRESULT XStoreDownloadAndInstallPackageUpdatesAsync(  
         const XStoreContextHandle storeContextHandle,  
         const char** packageIdentifiers,  
         size_t packageIdentifiersCount,  
         XAsyncBlock* async  
)  

매개 변수

storeContextHandle _In_
형식: XStoreContextHandle

XStoreCreateContext가 반환하는 사용자의 Microsoft Store 컨텍스트 핸들입니다.

packageIdentifiers _In_z_count_(packageIdentifiersCount)
형식: char**

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

packageIdentifiersCount _In_
형식: size_t

packageIdentifiers의 식별자 수입니다.

async _Inout_
형식: XAsyncBlock*

수행할 비동기 작업을 정의하는 XAsyncBlock입니다. 호출의 상태를 폴링하고 호출 결과를 검색하기 위해 사용할 수 있는 XAsyncBlock입니다. 자세한 내용은 XAsyncBlock을 참조하세요.

반환 값

형식: HRESULT

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

비고

이 함수는 지정된 Microsoft Store 패키지의 업데이트를 다운로드하고 설치합니다. 설치하지 않고 업데이트를 다운로드하려면 XStoreDownloadPackageUpdatesAsync를 호출해야 합니다. 무설치 다운로드는 게임플레이를 방해하지 않기 때문에 게임이 실행 중일 때 유용합니다. 업데이트 다운로드 및 설치 결과를 검색하려면 이 함수를 호출한 후 XStoreDownloadAndInstallPackageUpdatesResult를 호출합니다. 사용 예는 XStoreQueryGameAndDlcPackageUpdatesAsync를 참조하세요.

실행 중인 게임에서 이 API가 호출되면 다운로드는 높은 우선 순위로 간주되며 이 API의 storeIds 매개 변수에 지정된 순서대로 큐의 시작 부분에 이동합니다.

요구 사항

헤더: XStore.h(XGameRuntime.h에 포함됨)

라이브러리: xgameruntime.lib

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

참고 항목

XStore
XStoreDownloadAndInstallPackageUpdatesResult
XStoreDownloadPackageUpdatesAsync