Share via


XStoreCanAcquireLicenseForStoreIdResult

Gets the results for a call to XStoreCanAcquireLicenseForStoreIdAsync.

Syntax

HRESULT XStoreCanAcquireLicenseForStoreIdResult(  
         XAsyncBlock* async,  
         XStoreCanAcquireLicenseResult* storeCanAcquireLicense  
)  

Parameters

async   _Inout_
Type: XAsyncBlock*

The XAsyncBlock that was passed to XStoreCanAcquireLicenseForStoreIdAsync. The XAsyncBlock can be used to poll for the call's status and retrieve call results. See XAsyncBlock for more information.

storeCanAcquireLicense   _Out_
Type: XStoreCanAcquireLicenseResult*

On return indicates if the user would be able to license the requested product. This product can be a game, durable, or durable with package. It will also return a result if the product can be licensed by an inserted disc. The result will indicate what SKU the user would be able to license. Note that no SKU will be returned in the case where content is able to be licensed via disc.

Return value

Type: HRESULT

S_OK on success; otherwise, returns an error code.

The following error codes may be returned by XStoreCanAcquireLicenseForStoreIdResult:

Error code Meaning
0x87E10BC6 LM_E_CONTENT_NOT_IN_CATALOG The product was not found in the catalog.
0x803F8001 LM_E_CONTENT_NOT_OWNED The product is not owned.
0x803F8008 LM_E_PREDOWNLOAD_LICENSE_NOT_YET_AVAILABLE The product is owned but cannot be licensed because it has not been released yet.
0x803F9006 LM_E_ENTITLED_USER_SIGNED_OUT Owner of the product is not signed in.
0x89245305 E_GAMESTORE_LICENSE_ACTION_THROTTLED The game has excessively previewed a license for the product and is now being throttled.

Remarks

This result function allows you to retrieve the execution results of XStoreCanAcquireLicenseForStoreIdAsync, as well as the preview license that was called for if the execution was successful. This function should be called after XStoreCanAcquireLicenseForStoreIdAsync has been called, usually in the context of a callback function. See XStoreCanAcquireLicenseForStoreIdAsync for a usage example.

Requirements

Header: XStore.h (included in XGameRuntime.h)

Library: xgameruntime.lib

Supported platforms: Windows, Xbox One family consoles and Xbox Series consoles

See also

XStore
XStoreCanAcquireLicenseForStoreIdAsync