XStoreDownloadPackageUpdatesAsync

지정된 Microsoft Store 패키지의 업데이트를 설치하지 않고 다운로드합니다. 이렇게 하면 사용자가 플레이하는 동안 게임이 종료되지 않도록, 업데이트 설치 시점을 게임에서 제어할 수 있습니다.

구문

HRESULT XStoreDownloadPackageUpdatesAsync(  
         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 패키지에 대한 고유한 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