메인 콘텐츠로 건너뛰기

​
XStoreDownloadPackageUpdatesAsync

XBOX에서는 업데이트가 다운로드되는 대로 설치되므로 이 API는 의도한 대로 작동하지 않습니다. 업데이트가 게임용인 경우 게임이 종료됩니다. 업데이트가 DLC용인 경우 DLC 패키지가 현재 탑재되어 있으면 게임이 종료됩니다.대신 XStoreDownloadAndInstallPackageUpdatesAsync를 사용하세요.
지정된 패키지의 업데이트를 설치하지 않고 다운로드합니다. 이를 통해 게임에서 업데이트 설치 시점을 제어하여 사용자가 플레이하는 동안 게임이 종료되지 않도록 할 수 있습니다.

​
구문

​
매개 변수

storeContextHandle   _In_
형식: XStoreContextHandle XStoreCreateContext가 반환한 사용자의 스토어 컨텍스트 핸들입니다. packageIdentifiers   _In_z_count_(packageIdentifiersCount)
형식: char** 패키지 식별자 목록입니다. 패키지 식별자는 Microsoft Store 패키지의 고유 ID 문자열입니다. 패키지 식별자에 대한 자세한 내용은 다운로드 가능한 콘텐츠(DLC) 관리 및 라이선스를 참조하세요. packageIdentifiersCount   _In_
형식: size_t packageIdentifiers의 식별자 수입니다. async   _Inout_
형식: XAsyncBlock* 수행 중인 비동기 작업을 정의하는 XAsyncBlock입니다. XAsyncBlock을 사용하여 호출의 상태를 폴링하고 호출 결과를 검색할 수 있습니다. 자세한 내용은 XAsyncBlock을 참조하세요.

​
반환 값

형식: HRESULT 성공하면 S_OK를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

​
설명

이 함수는 업데이트를 다운로드만 하고 설치하지는 않습니다. 한 번의 호출로 업데이트를 다운로드하고 설치하려면 XStoreDownloadAndInstallPackageUpdatesAsync 함수를 사용합니다. 이 함수의 결과를 검색하려면 이 함수를 호출한 후 XStoreDownloadPackageUpdatesResult를 호출합니다. 사용 예제는 XStoreQueryGameAndDlcPackageUpdatesAsync를 참조하세요. 실행 중인 게임에서 이 API를 호출하면 다운로드는 높은 우선 순위로 간주되며, 이 API의 storeIds 매개 변수에 지정된 순서대로 큐의 맨 앞에 배치됩니다.

​
요구 사항

헤더: XStore.h(XGameRuntime.h에 포함됨) 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 본체 및 XBOX Series 본체

​
참고 항목

XStore
XStoreDownloadPackageUpdatesResult
XStoreDownloadAndInstallPackageUpdatesAsync
마지막 수정일 2026년 10월 19일