Skip to main content

XStoreDownloadPackageUpdatesAsync

지정된 패키지의 업데이트를 설치하지 않고 다운로드합니다. 이를 통해 사용자가 플레이 중인 동안 게임이 종료되는 것을 방지하기 위해 게임이 업데이트 설치 시점을 제어할 수 있습니다.

구문

매개 변수

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년 8월 24일