XPackageUnregisterPackageInstalled
取消注册以前注册的包已安装回调。
语法
bool XPackageUnregisterPackageInstalled(
XTaskQueueRegistrationToken token,
bool wait
)
参数
token _In_
类型：XTaskQueueRegistrationToken
XPackageRegisterPackageInstalled 返回的令牌。
wait _In_
类型：bool
指示是否阻止直到完成所有挂起的回调。
返回值
类型：bool
如果 wait 为 false 且正在挂起取消注册，则返回 false。 否则，返回 true。
备注
注意
在时间敏感线程上调用此函数是不安全的。 有关详细信息，请参阅时间敏感线程。
按以下方式取消注册通知行为：
- 从注册的回调集中，取消注册删除与令牌关联的回调。
- 如果对于该回调令牌未执行任何回调，则调用返回 true。
- 如果回调正在执行且 wait 为 true，将阻止调用直到完成执行的回调。
- 如果回调正在执行且 wait 为 false，将不阻止调用，但是会返回 false。 完成该令牌的回调后，自动取消注册令牌。
此机制允许以下编码模式：
- 您可以在取消注册时阻止，以确保在取消注册调用后从不调用您的回调。
- 您可以选择不阻止。 要确保在删除数据前完成您的回调，可以定期调用取消注册且使 wait 为 false。 当它最终返回 true 时，所有您的回调都已完成，且您可以删除状态。
- 如果您的回调不介意在取消注册调用期间自己是否被调用，您可以仅为 wait 传递 false 并忽略返回值。
以下代码示例说明如何使用 XPackageUnregisterPackageInstalled：
void StopListeningForDlc(XTaskQueueRegistrationToken token)
{
XPackageUnregisterPackageInstalled(token, false);
}
要求
头文件：XPackage.h
库：xgameruntime.lib
支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机