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

# XStoreAcquireLicenseForDurablesAsync

> XStoreAcquireLicenseForDurablesAsync

# XStoreAcquireLicenseForDurablesAsync

DLC(패키지가 있는 Durable), 패키지가 없는 Durable 또는 Durable 추가 기능 제품에 대한 라이선스를 획득합니다.

## 구문

```cpp theme={null}
HRESULT XStoreAcquireLicenseForDurablesAsync(
         const XStoreContextHandle storeContextHandle,
         const char* storeId,
         XAsyncBlock* async
)
```

### 매개 변수

*storeContextHandle*   \_In\_\
형식: XStoreContextHandle

[XStoreCreateContext](https://docs.xbox.com/ko/reference/system/xstore/functions/xstorecreatecontext.md)가 반환한 사용자의 스토어 컨텍스트 핸들입니다.

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

라이선스를 획득할 durable의 스토어 ID입니다.

*async*   \_Inout\_\
형식: 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)을 사용하여 호출 상태를 확인하고 호출 결과를 가져옵니다.
자세한 내용은 [XAsyncBlock](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)을 참조하세요.

### 반환 값

형식: HRESULT

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

## 설명

이 API는 요청된 durable에 대한 라이선스 획득을 시도합니다.
디바이스가 처음으로 라이선스를 획득하는 경우 서비스 호출이 이루어지므로 온라인 연결이 필요합니다.
캐싱으로 인해 동일한 라이선스에 대한 후속 호출은 더 빠를 수 있지만 라이선스는 언제든지 무효화될 수 있습니다.
콘솔에서 오프라인 액세스를 하려면 소유 계정에 대해 'Home XBOX'가 사용하도록 설정되어야 하고 라이선스는 먼저 온라인 상태에서 한 번 얻어야 합니다.
PC의 경우 오프라인 액세스를 하려면 라이선스를 소유하는 계정에 대해 '오프라인 사용 권한'이 설정되어야 하고 라이선스는 먼저 온라인 상태에서 한 번 얻어야 합니다.

[XStoreRegisterPackageLicenseLost](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreregisterpackagelicenselost.md)를 사용하여 이 API에서 얻은 라이선스가 손실되었는지 모니터링할 수 있습니다.

## 요구 사항

**헤더:** XStore.h

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

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

## 개념 설명서

* [Basic store operations](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-basic-operations.md)
* [How to use a durable without a package](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-dwob.md)
* [Granting players access to add-on content](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-granting-access.md)
* [Enabling licensing testing](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-licensing-setup.md)

## 참고 항목

[XStore](https://docs.xbox.com/ko/reference/system/xstore/xstore_members.md)\
[XAsyncBlock](https://docs.xbox.com/ko/reference/system/xasync/structs/xasyncblock.md)\
[XStoreAcquireLicenseForDurablesResult](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreacquirelicensefordurablesresult.md)\
[How to use a durable without a package](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-dwob.md)\
[Granting players access to add-on content](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-granting-access.md)


## Related topics

- [XStoreAcquireLicenseForDurablesResult](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreacquirelicensefordurablesresult.md)
- [XStoreAcquireLicenseForPackageAsync](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreacquirelicenseforpackageasync.md)
- [패키지 없는 durable 사용 방법](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-dwob.md)
- [XStoreRegisterPackageLicenseLost](https://docs.xbox.com/ko/reference/system/xstore/functions/xstoreregisterpackagelicenselost.md)
- [라이선싱 테스트 활성화](https://docs.xbox.com/ko/publishing/xstore-commerce/xstore-licensing-setup.md)