XStoreRegisterPackageLicenseLost

注册许可证丢失事件的回调。 这可用于注册通过 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