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*
用于定义正在进行的异步工作的 XAsyncBlock。 XAsyncBlock 可用于轮询调用的状态和检索调用结果。 有关详细信息,请参阅 XAsyncBlock。
返回值
类型:HRESULT
成功时返回 S_OK,否则返回错误代码。
备注
此 API 是为没有包附加类型的耐用品准备的。 对于带程序包的耐用品,请改为使用 XStoreAcquireLicenseForPackageAsync。
该 API 试图获取请求的耐用品的许可证。 如果这是此设备首次获取许可证,则会调用服务,因此需要联机连接。 由于缓存,对同一许可证的后续调用可能会更快,但可能会随时失效。 仅当联机时获得一次许可证时,才能脱机访问此许可证。 对于电脑,这需要为拥有许可证的帐户设置脱机权限。
XStoreRegisterPackageLicenseLost 可用于监视从此 API 获取的许可证是否丢失。
要求
头文件:XStore.h
库:xgameruntime.lib
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机