XStoreAcquireLicenseForDurablesAsync

获取不带程序包或耐用品加载项产品的耐用品许可证。

注意

此 API 不适用于具有程序包产品类型的耐用品。 如果尝试为具有程序包的耐用品调用此 API,XStoreAcquireLicenseForDurablesResult 将返回错误。 若要获取具有程序包的耐用品的许可证,请使用 XStoreAcquireLicenseForPackageAsync

语法

HRESULT XStoreAcquireLicenseForDurablesAsync(
         const XStoreContextHandle storeContextHandle,
         const char* storeId,
         XAsyncBlock* async
)

参数

storeContextHandle _In_
类型:XStoreContextHandle

XStoreCreateContext 返回的用户的应用商店上下文句柄。

storeId _In_z_
类型:char*

为其获取许可证的耐用品 store ID。

async _Inout_
类型:XAsyncBlock*

用于定义正在进行的异步工作的 XAsyncBlockXAsyncBlock 可用于轮询调用的状态和检索调用结果。 有关详细信息,请参阅 XAsyncBlock

返回值

类型:HRESULT

成功时返回 S_OK,否则返回错误代码。

备注

此 API 是为没有包附加类型的耐用品准备的。 对于带程序包的耐用品,请改为使用 XStoreAcquireLicenseForPackageAsync

该 API 试图获取请求的耐用品的许可证。 如果这是此设备首次获取许可证,则会调用服务,因此需要联机连接。 由于缓存,对同一许可证的后续调用可能会更快,但可能会随时失效。 仅当联机时获得一次许可证时,才能脱机访问此许可证。 对于电脑,这需要为拥有许可证的帐户设置脱机权限。

XStoreRegisterPackageLicenseLost 可用于监视从此 API 获取的许可证是否丢失。

要求

头文件:XStore.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XStore
XAsyncBlock
XStoreAcquireLicenseForDurablesResult