> ## 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.

# XStoreAcquireLicenseForPackageResult

> XStoreAcquireLicenseForPackageResult

# XStoreAcquireLicenseForPackageResult

[XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) 호출의 결과를 검색합니다.

## 구문

```cpp theme={null}
HRESULT XStoreAcquireLicenseForPackageResult(  
         XAsyncBlock* async,  
         XStoreLicenseHandle* storeLicenseHandle  
)  
```

### 매개 변수

*async*   \_Inout\_\
형식: [XAsyncBlock\*](/reference/system/xasync/structs/xasyncblock)

[XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync)에 전달된 XAsyncBlock입니다.
[XAsyncBlock](/reference/system/xasync/structs/xasyncblock)을 사용하여 호출 상태를 확인하고 결과를 가져옵니다.
자세한 내용은 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock)을 참조하세요.

*storeLicenseHandle*   \_Out\_\
형식: XStoreLicenseHandle\*

호출에 성공하면 이 값은 스토어 라이선스에 대한 핸들입니다.

### 반환 값

형식: HRESULT

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

`XStoreAcquireLicenseForPackageResult`는 다음 오류 코드를 반환할 수 있습니다.

| 오류 코드                                                   | 설명                                                                              |
| ------------------------------------------------------- | ------------------------------------------------------------------------------- |
| 0x87E10BC6 `LM_E_CONTENT_NOT_IN_CATALOG`                | 카탈로그에서 제품을 찾을 수 없습니다.                                                           |
| 0x803F8001 `LM_E_CONTENT_NOT_OWNED`                     | 제품이 소유되지 않았습니다.                                                                 |
| 0x803F8008 `LM_E_PREDOWNLOAD_LICENSE_NOT_YET_AVAILABLE` | 제품이 소유되어 있지만 아직 릴리스되지 않았기 때문에 라이선스를 부여할 수 없습니다.                                 |
| 0x803F9006 `LM_E_ENTITLED_USER_SIGNED_OUT`              | 제품 소유자가 로그인되어 있지 않습니다.                                                          |
| 0x89245305 `E_GAMESTORE_LICENSE_ACTION_THROTTLED`       | 게임이 제품에 대한 라이선스를 지나치게 많이 쿼리하여 이제 제한됩니다. 동일한 제품에 대해 10분 이내에 30번의 라이선스 시도로 제한됩니다. |

## 설명

이 함수는 시간에 민감한 스레드에서 안전하게 호출할 수 있습니다.

이 결과 함수는 [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync)의 실행 결과와 실행이 성공하면 해당 함수가 요청하는 라이선스를 검색합니다.
따라서 이 함수는 [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync) 이후에 호출되어야 하며, 일반적으로 콜백 함수의 컨텍스트에서 호출됩니다.
라이선스가 반환되면 [XStoreIsLicenseValid](/reference/system/xstore/functions/xstoreislicensevalid)를 호출하여 라이선스가 유효한지 확인합니다.

사용 예제는 [XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync)를 참조하세요.

## 요구 사항

**헤더:** XStore.h(XGameRuntime.h에 포함됨)

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

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

## 개념 설명서

* [Granting players access to add-on content](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-granting-access-to-content)

## 참고 항목

[XStore](/reference/system/xstore/xstore_members)\
[XStoreAcquireLicenseForPackageAsync](/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync)\
[XStoreAcquireLicenseForPackageResult](/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult)\
[XStoreIsLicenseValid](/reference/system/xstore/functions/xstoreislicensevalid)\
[XStoreCloseLicenseHandle](/reference/system/xstore/functions/xstorecloselicensehandle)\
[XStoreRegisterPackageLicenseLost](/reference/system/xstore/functions/xstoreregisterpackagelicenselost)\
[XStoreUnregisterPackageLicenseLost](/reference/system/xstore/functions/xstoreunregisterpackagelicenselost)\
[Manage and license downloadable content (DLC)](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-manage-and-license-optional-packages)


## Related topics

- [XStoreAcquireLicenseForPackageAsync](/ko/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md)
- [XStoreIsLicenseValid](/ko/reference/system/xstore/functions/xstoreislicensevalid.md)
- [XStoreCloseLicenseHandle](/ko/reference/system/xstore/functions/xstorecloselicensehandle.md)
- [XStoreUnregisterPackageLicenseLost](/ko/reference/system/xstore/functions/xstoreunregisterpackagelicenselost.md)
- [XStoreRegisterPackageLicenseLost](/ko/reference/system/xstore/functions/xstoreregisterpackagelicenselost.md)