> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStoreQueryPackageIdentifier

> XStoreQueryPackageIdentifier

# XStoreQueryPackageIdentifier

지정된 스토어 ID에 대한 패키지 식별자를 검색합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT XStoreQueryPackageIdentifier(
         const char* storeId,
         size_t size,
         char* packageIdentifier
)
```

<a id="parametersSection" />

### 매개 변수

*storeId*   \_In\_z\_\
형식: char\*

패키지를 포함하는 제품의 스토어 ID입니다.

*size*   \_In\_\
형식: size\_t

패키지 식별자의 문자 수입니다. 이 크기는 최소 XPACKAGE\_IDENTIFIER\_MAX\_LENGTH(33) 이상이어야 합니다.

*packageIdentifier*   \_Out\_writes\_z\_(size)\
형식: char\*

성공 시 패키지 식별자를 포함합니다. 패키지 식별자에 대한 자세한 내용은 [다운로드 가능 콘텐츠(DLC) 관리 및 라이선싱](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-manage-and-license-optional-packages)을 참조하세요.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

성공하면 **S\_OK**를 반환하고, 그렇지 않으면 오류 코드를 반환합니다.

| 오류 코드                     | 설명                          |
| ------------------------- | --------------------------- |
| 0x80070057 `E_INVALIDARG` | 스토어 ID에 해당하는 설치된 패키지가 없습니다. |

<a id="remarksSection" />

## 설명

지정된 스토어 패키지를 다운로드하고 설치하려면 [XStoreDownloadAndInstallPackagesAsync](/reference/system/xstore/functions/xstoredownloadandinstallpackagesasync)를 호출합니다.

`XStoreDownloadAndInstallPackagesAsync` 호출의 결과를 얻으려면 [XStoreDownloadAndInstallPackagesResult](/reference/system/xstore/functions/xstoredownloadandinstallpackagesresult)를 호출합니다.

`XStoreDownloadAndInstallPackagesResult`에서 반환되는 결과의 항목 수를 얻으려면 [XStoreDownloadAndInstallPackagesResultCount](/reference/system/xstore/functions/xstoredownloadandinstallpackagesresultcount)를 호출합니다.

<a id="requirementsSection" />

## 요구 사항

**헤더:** XStore.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

<a id="seealsoSection" />

## 참고 항목

[XStore](/reference/system/xstore/xstore_members)


## Related topics

- [XStore](/ko/reference/system/xstore/xstore_members.md)
- [GDK용 Unity C# API 래퍼](/ko/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [XStoreQueryPackageUpdatesAsync](/ko/reference/system/xstore/functions/xstorequerypackageupdatesasync.md)
- [XStoreQueryProductForPackageAsync](/ko/reference/system/xstore/functions/xstorequeryproductforpackageasync.md)
- [XStoreQueryProductForPackageResult](/ko/reference/system/xstore/functions/xstorequeryproductforpackageresult.md)