Skip to main content

XPackageUnregisterInstallationProgressChanged

Anula el registro de una devolución de llamada de cambio de progreso de instalación registrada previamente.

Sintaxis

Parámetros

installationMonitor   _In_
Tipo: XPackageInstallationMonitorHandle
El monitor de instalación del que se va a quitar la devolución de llamada especificada. token   _In_
Tipo: XTaskQueueRegistrationToken
El token devuelto por XPackageRegisterInstallationProgressChanged. wait   _In_
Tipo: bool
Indica si se debe bloquear hasta que se completen las devoluciones de llamada pendientes.

Valor devuelto

Tipo: bool Si wait es false y la anulación del registro está pendiente, devuelve false. De lo contrario, devuelve true.

Comentarios

No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte Subprocesos sensibles al tiempo.
La anulación del registro de una notificación se comporta de la siguiente manera:
  • Del conjunto de devoluciones de llamada registradas, la anulación del registro quita la devolución de llamada asociada al token.
  • Si no se está ejecutando ninguna devolución de llamada para ese token de devolución de llamada, la llamada devuelve true.
  • Si se están ejecutando devoluciones de llamada y wait es true, la llamada se bloqueará hasta que la devolución de llamada en ejecución haya terminado.
  • Si se están ejecutando devoluciones de llamada y wait es false, la llamada no se bloqueará, pero devolverá false. Una vez completada la devolución de llamada del token, el registro del token se anula automáticamente.
Este mecanismo permite los siguientes patrones de codificación:
  1. Puede bloquear en la anulación del registro para garantizar que sus devoluciones de llamada nunca se invoquen después de una llamada de anulación del registro.
  2. Puede optar por no bloquear. Para asegurarse de que sus devoluciones de llamada se hayan completado antes de eliminar datos, llame periódicamente a la anulación del registro con false en wait. Cuando finalmente devuelva true, todas sus devoluciones de llamada habrán terminado y podrá eliminar el estado.
  3. Si a su devolución de llamada no le importa si se está invocando durante una llamada de anulación del registro, puede simplemente pasar false en wait e ignorar el valor devuelto.
Ejemplo:

Requisitos

Encabezado: XPackage.h Biblioteca: xgameruntime.lib Plataformas compatibles: Windows, consolas de la familia XBOX One y consolas XBOX Series

Documentación conceptual

Consulte también

XPackage
Instalación por streaming y entrega inteligente
Última modificación el 28 de agosto de 2026