XStoreQueryAssociatedProductsForStoreIdAsync
스토어 ID로 지정된 대상 제품과 관련된 구매 가능한 제품의 스토어 목록 정보를 가져옵니다.구문
매개 변수
storeContextHandle _In_형식: XStoreContextHandle XStoreCreateContext에서 반환된 사용자의 스토어 컨텍스트 핸들입니다. storeId _In_
형식: const char* 연결된 제품을 검색할 제품의 스토어 ID입니다. productKinds _In_
형식: XStoreProductKind 반환할 제품의 형식입니다. maxItemsToRetrievePerPage _In_
형식: uint32_t 페이지당 검색할 최대 항목 수입니다. 페이지당 반환되는 항목 수는 0에서
maxItemsToRetrievePerPage 사이일 수 있습니다.
async _Inout_형식: XAsyncBlock* 수행 중인 비동기 작업을 정의하는 XAsyncBlock입니다. XAsyncBlock을 사용하여 호출 상태를 폴링하고 호출 결과를 검색합니다. 자세한 내용은 XAsyncBlock을 참조하세요.
반환 값
형식: HRESULT HRESULT 성공 또는 오류 코드입니다.설명
이 함수의 스토어 목록 정보 및 실행 결과를 얻으려면 이 함수를 호출한 후 XStoreQueryAssociatedProductsForStoreIdResult를 호출하세요. XStoreQueryAssociatedProductsForStoreIdResult에는 XStoreEnumerateProductsQuery를 호출하여 열거되는XStoreProductQueryHandle이 포함되어 있습니다.
이 API는 XStoreQueryAssociatedProductsAsync에 설명된 것과 동일한 페이징 패턴을 지원합니다.페이징은 샌드박스와 RETAIL 간에 다르게 동작할 수 있습니다.
페이징 구현을 확인하고 릴리스 전에 RETAIL에서 반드시 테스트하세요.자세한 내용은 페이징을 참조하세요.
-
개발자는
XPackageEnumeratePackages를 실행하여 설치된 XPackageKind::Game 제품을 열거한 다음, 이러한 게임 중 하나에 대해XPackageDetails에서 가져온 storeId를 사용하여XStoreQueryAssociatedProductsForStoreIdAsync를 실행합니다. 개발자는 XPackageKind::Content에 대해XPackageEnumeratePackages를 실행하여 설치된 DLC를 열거합니다. 콘텐츠 열거 및 제품 쿼리의 결과가 상호 참조되어 특정 게임에 어떤 DLC가 설치되어 있는지 식별할 수 있습니다. -
개발자는
XStoreQueryAssociatedProductsAsync를 실행하여 현재 게임과 연결된 구매 가능한 제품 목록을 가져옵니다. 그런 다음 대상 게임의XStoreProduct의 storeId를 사용하여XStoreQueryAssociatedProductsForStoreIdAsync를 실행하여 어떤 DLC가 연결되어 있는지 확인합니다.
요구 사항
헤더: XStore.h (XGameRuntime.h에 포함됨) 라이브러리: xgameruntime.lib 지원 플랫폼: Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔개념 설명서
참고 항목
XStoreXStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
