注册许可证丢失事件的回调。 这可用于注册通过 XStoreAcquireLicenseForPackageAsync 获得的带有包的耐用品和通过 XStoreAcquireLicenseForDurablesAsync 获得的不带包的耐用品(又称耐用附加内容)的许可证。
语法
HRESULT XStoreRegisterPackageLicenseLost(
XStoreLicenseHandle licenseHandle,
XTaskQueueHandle queue,
void* context,
XStorePackageLicenseLostCallback* callback,
XTaskQueueRegistrationToken* token
)
参数
licenseHandle _In_
类型:XStoreLicenseHandle
要为其注册回调的许可证句柄。
queue _In_
类型:XTaskQueueHandle
处理异步工作的异步队列。
context _In_opt_
类型:void*
要传递给回调的游戏定义的上下文。
callback _In_
类型:XStorePackageLicenseLostCallback*
要注册的回调。
token _Out_
类型:XTaskQueueRegistrationToken*
成功时包含用于标识回调的令牌。
返回值
类型:HRESULT
HRESULT 成功或错误代码。
备注
此函数注册由 XStorePackageLicenseLostCallback 定义的回调函数。 注册的函数将在发生下一个游戏许可证更改事件时调用。 注册的函数不会由注册行为调用。 大多数情况下,当用户超出对指定包的并发限制时,会引发此函数。 当用户在其他漫游设备上打开包时,通常会发生这种情况。 为了避免内存泄漏,在完成回调函数后,必须调用 XStoreUnregisterPackageLicenseLost。
有关使用示例,请参阅 XStoreAcquireLicenseForPackageAsync。
要求
头文件:XStore.h(包含在 XGameRuntime.h 中)
库:xgameruntime.lib
支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机
另请参阅
XStore
XStoreAcquireLicenseForPackageAsync
XStoreAcquireLicenseForPackageResult
XStoreIsLicenseValid
XStoreCloseLicenseHandle
XStorePackageLicenseLostCallback
XStoreUnregisterPackageLicenseLost