StoreContext.GetAppAndOptionalStorePackageUpdatesAsync Método

public:
 virtual IAsyncOperation<IVectorView<StorePackageUpdate ^> ^> ^ GetAppAndOptionalStorePackageUpdatesAsync() = GetAppAndOptionalStorePackageUpdatesAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorePackageUpdate>> GetAppAndOptionalStorePackageUpdatesAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorePackageUpdate>> GetAppAndOptionalStorePackageUpdatesAsync();

function getAppAndOptionalStorePackageUpdatesAsync()

Public Function GetAppAndOptionalStorePackageUpdatesAsync () As IAsyncOperation(Of IReadOnlyList(Of StorePackageUpdate))

Devoluciones

Una operación asincrónica que, al finalizar correctamente, devuelve una colección de objetos StorePackageUpdate que representan los paquetes que tienen actualizaciones disponibles.

Atributos

RemoteAsyncAttribute

Excepciones

Comentarios

Para obtener más información sobre el uso de este método, incluido un ejemplo de código, consulta Descargar e instalar actualizaciones de paquetes para la aplicación.

Después de llamar a GetAppAndOptionalStorePackageUpdatesAsync para determinar qué paquetes tienen actualizaciones disponibles, puede llamar a RequestDownloadStorePackageUpdatesAsync para descargar los paquetes actualizados o puede llamar a RequestDownloadAndInstallStorePackageUpdatesAsync para descargar e instalar los paquetes actualizados.

Requisitos previos y requisitos del entorno

Para que este método funcione correctamente, se deben cumplir las condiciones siguientes:

• Microsoft Store app: la aplicación Microsoft Store debe estar instalada y funcional en el sistema.
• cuenta Microsoft: aunque un cuenta Microsoft de sesión no es estrictamente necesario para comprobar las actualizaciones, es posible que determinados escenarios requieran autenticación.
• Store services: los servicios de licencias y actualizaciones de Microsoft Store deben estar en ejecución y accesibles.
• Conectividad de red: se requiere una conexión a Internet activa para comunicarse con el servicio Microsoft Store.

Compatibilidad con el modo de acceso asignado

Este método se puede usar en el modo acceso asignado (quiosco), pero se aplican las siguientes consideraciones:

• La cuenta de acceso asignada debe tener permiso para acceder a Microsoft Store servicios.
• El acceso a la red debe configurarse para permitir la comunicación con puntos de conexión de Microsoft Store.
• Algunos elementos de la interfaz de usuario de Store pueden estar restringidos en función de la configuración de acceso asignada.

Recomendaciones de control de errores

Al llamar a este método, se recomienda implementar el control de errores adecuado:

try
{
    var updates = await storeContext.GetAppAndOptionalStorePackageUpdatesAsync();
    // Process updates
}
catch (System.Runtime.InteropServices.COMException ex)
{
    // Handle COM-related errors (e.g., threading issues)
}
catch (System.Exception ex)
{
    // Handle Store service errors (e.g., service unavailable)
    // Log the error and implement appropriate retry logic
}

Disponibilidad de actualizaciones

Después de publicar una actualización de la aplicación en el Centro de partners, puede haber un breve retraso entre cuando el paquete pasa la certificación y cuando el método GetAppAndOptionalStorePackageUpdatesAsync reconoce que la actualización está disponible. La mayoría de las actualizaciones están disponibles en un par de horas, pero algunos pasos de publicación y distribución pueden tardar más tiempo en finalizar en determinados casos.

Frecuencia de detección

Esta API limita la frecuencia con la que comprueba si hay nuevas actualizaciones. Cuando una aplicación llama al método con más frecuencia que la tasa permitida, el método devuelve el último estado conocido en lugar de realizar una nueva comprobación.

Los límites actuales son:

• No hay más de una comprobación cada 30 minutos.
• No más de diez comprobaciones dentro de un período de 24 horas.

Si una aplicación supera estos límites, el método continúa devolviendo el estado anterior hasta que pase el período de tiempo aplicable.

Consulte también

• Descarga e instalación de actualizaciones de paquetes para la aplicación
• Creación de paquetes opcionales y conjuntos relacionados