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

# XStoreAcquireLicenseForPackageResult

> XStoreAcquireLicenseForPackageResult

# XStoreAcquireLicenseForPackageResult

[XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md) 호출의 결과를 검색합니다.

## 구문

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

### 매개 변수

*async*   \_Inout\_\
형식: [XAsyncBlock\*](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)

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

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

사용 예제는 [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md)를 참조하세요.

## 요구 사항

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

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

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

## 개념 설명서

* [Granting players access to add-on content](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-granting-access.md)

## 참고 항목

[XStore](https://docs.xbox.com/ko/reference/system/xstore/xstore_members.md)\
[XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md)\
[XStoreAcquireLicenseForPackageResult](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreacquirelicenseforpackageresult.md)\
[XStoreIsLicenseValid](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreislicensevalid.md)\
[XStoreCloseLicenseHandle](https://docs.xbox.com/ko/reference/system/xstore/functions/xstorecloselicensehandle.md)\
[XStoreRegisterPackageLicenseLost](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreregisterpackagelicenselost.md)\
[XStoreUnregisterPackageLicenseLost](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreunregisterpackagelicenselost.md)\
[Manage and license downloadable content (DLC)](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-dlc.md)


## Related topics

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