메인 콘텐츠로 건너뛰기

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에서 반드시 테스트하세요.자세한 내용은 페이징을 참조하세요.
이 쿼리가 반환하는 제품의 수는 미리 알 수 없습니다. 이 API를 사용하여 대상 제품의 스토어 ID로 해당 제품과 연결된 추가 기능(add-on)을 찾을 수 있습니다. 이 기능은 Franchise Game Hub에 특히 유용합니다. Franchise Game Hub는 여러 게임에 대한 추가 기능을 열거할 수 있지만, 이러한 추가 기능이 어떤 게임과 연결되어 있는지는 알 수 없습니다. 사용 시나리오 예시:
  • 개발자는 XPackageEnumeratePackages를 실행하여 설치된 XPackageKind::Game 제품을 열거한 다음, 이러한 게임 중 하나에 대해 XPackageDetails에서 가져온 storeId를 사용하여 XStoreQueryAssociatedProductsForStoreIdAsync를 실행합니다. 개발자는 XPackageKind::Content에 대해 XPackageEnumeratePackages를 실행하여 설치된 DLC를 열거합니다. 콘텐츠 열거 및 제품 쿼리의 결과가 상호 참조되어 특정 게임에 어떤 DLC가 설치되어 있는지 식별할 수 있습니다.
  • 개발자는 XStoreQueryAssociatedProductsAsync를 실행하여 현재 게임과 연결된 구매 가능한 제품 목록을 가져옵니다. 그런 다음 대상 게임의 XStoreProduct의 storeId를 사용하여 XStoreQueryAssociatedProductsForStoreIdAsync를 실행하여 어떤 DLC가 연결되어 있는지 확인합니다.
다음 코드 조각은 스토어 ID를 사용하여 대상 제품과 연결된 제품을 쿼리하는 예를 보여줍니다. 결과는 여러 페이지에 걸쳐 처리됩니다.

요구 사항

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

개념 설명서

참고 항목

XStore
XStoreQueryAssociatedProductsForStoreIdResult
XStoreQueryAssociatedProductsAsync
XStoreEnumerateProductsQuery
XStoreProductsQueryHasMorePages
XStoreProductsQueryNextPageAsync
마지막 수정일 2026년 10월 19일