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

# XStoreAcquireLicenseForDurablesAsync

> XStoreAcquireLicenseForDurablesAsync

# XStoreAcquireLicenseForDurablesAsync

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

<a id="syntaxSection" />

## 구문

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

<a id="parametersSection" />

### 매개 변수

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

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

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

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

*async*   \_Inout\_\
형식: XAsyncBlock\*

비동기 작업을 정의하는 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock)입니다.
[XAsyncBlock](/reference/system/xasync/structs/xasyncblock)을 사용하여 호출 상태를 확인하고 호출 결과를 가져옵니다.
자세한 내용은 [XAsyncBlock](/reference/system/xasync/structs/xasyncblock)을 참조하세요.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

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

<a id="remarksSection" />

## 설명

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

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

<a id="requirementsSection" />

## 요구 사항

**헤더:** XStore.h

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

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

<a id="seealsoSection" />

## 개념 설명서

* [Basic store operations](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-basic-store-operations)
* [How to use a durable without a package](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-dwobs)
* [Granting players access to add-on content](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-granting-access-to-content)
* [Enabling licensing testing](/publishing/xstore-commerce/xstore-licensing-setup)

## 참고 항목

[XStore](/reference/system/xstore/xstore_members)\
[XAsyncBlock](/reference/system/xasync/structs/xasyncblock)\
[XStoreAcquireLicenseForDurablesResult](/reference/system/xstore/functions/xstoreacquirelicensefordurablesresult)\
[How to use a durable without a package](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-dwobs)\
[Granting players access to add-on content](https://learn.microsoft.com/gaming/gdk/docs/store/commerce/fundamentals/xstore-granting-access-to-content)


## Related topics

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