AppInstallManager Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce membri per l'installazione di app a livello di codice, inclusa la possibilità di avviare un'installazione di un'app e ottenere un elenco di installazioni di app attualmente in corso.
public ref class AppInstallManager sealed/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class AppInstallManager final/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class AppInstallManager final[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class AppInstallManager[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class AppInstallManagerfunction AppInstallManager()Public NotInheritable Class AppInstallManager- Ereditarietà
- Attributi
Requisiti Windows
| Requisiti | Descrizione |
|---|---|
| Famiglia di dispositivi |
Windows 10 (è stato introdotto in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
|
| Funzionalità dell'app |
runFullTrust
|
Commenti
Importante
L'accesso a questa API è protetto da una funzionalità privata limitata alle app sviluppate da Microsoft.
Annotazioni
Evitare di chiamare AppInstallManager.StartProductInstallAsync o AppInstallManager.StartProductInstallForUserAsync durante la configurazione guidata di Windows.
Le richieste di installazione effettuate prima del completamento della configurazione guidata potrebbero non comportarsi come previsto perché i servizi correlati allo Store potrebbero non essere ancora completamente inizializzati.
Per ottenere risultati ottimali, chiamare questi metodi dopo il primo accesso dell'utente.
Cronologia delle versioni
| Windows versione | Versione dell'SDK | Valore aggiunto |
|---|---|---|
| 1511 | 10586 | Cancel(String,String) |
| 1511 | 10586 | GetIsAppAllowedToInstallAsync(String,String,String,String,String) |
| 1511 | 10586 | Pause(String,String) |
| 1511 | 10586 | Restart(String,String) |
| 1511 | 10586 | SearchForAllUpdatesAsync(String) |
| 1511 | 10586 | SearchForUpdatesAsync(String,String,String,String) |
| 1511 | 10586 | StartAppInstallAsync(String,String,Boolean,Boolean,String,String,String) |
| 1511 | 10586 | UpdateAppByPackageFamilyNameAsync(String,String) |
| 1607 | 14393 | GetIsAppAllowedToInstallForUserAsync |
| 1607 | 14393 | GetIsApplicableForUserAsync |
| 1607 | 14393 | MoveToFrontOfDownloadQueue |
| 1607 | 14393 | SearchForAllUpdatesForUserAsync(User,String) |
| 1607 | 14393 | SearchForUpdatesForUserAsync(User,String,String,String,String,String) |
| 1607 | 14393 | StartProductInstallAsync(String,String,String,String,Boolean,Boolean,String,PackageVolume) |
| 1607 | 14393 | StartProductInstallForUserAsync(User,String,String,String,String,String,Boolean,Boolean,String,PackageVolume) |
| 1607 | 14393 | UpdateAppByPackageFamilyNameForUserAsync |
| 1703 | 15063 | AppInstallItemsWithGroupSupport |
| 1703 | 15063 | GetFreeDeviceEntitlementAsync |
| 1703 | 15063 | GetFreeUserEntitlementAsync |
| 1703 | 15063 | GetFreeUserEntitlementForUserAsync |
| 1803 | 17134 | GetIsPackageIdentityAllowedToInstallAsync |
| 1803 | 17134 | GetIsPackageIdentityAllowedToInstallForUserAsync |
| 1803 | 17134 | SearchForAllUpdatesAsync(String,String,AppUpdateOptions) |
| 1803 | 17134 | SearchForAllUpdatesForUserAsync(User,String,String,AppUpdateOptions) |
| 1803 | 17134 | SearchForUpdatesAsync(String,String,String,String,AppUpdateOptions) |
| 1803 | 17134 | SearchForUpdatesForUserAsync(User,String,String,String,String,String,AppUpdateOptions) |
| 1803 | 17134 | StartProductInstallAsync(String,String,String,String,AppInstallOptions) |
| 1803 | 17134 | StartProductInstallForUserAsync(User,String,String,String,String,String,AppInstallOptions) |
| 1809 | 17763 | CanInstallForAllUsers |
Costruttori
| Nome | Descrizione |
|---|---|
| AppInstallManager() |
Crea e inizializza una nuova istanza della classe AppInstallManager . |
Proprietà
| Nome | Descrizione |
|---|---|
| AcquisitionIdentity |
Ottiene o imposta l'identità utente associata alle installazioni dell'app. |
| AppInstallItems |
Recupera informazioni su tutte le app attualmente presenti nella coda di installazione. |
| AppInstallItemsWithGroupSupport |
Recupera informazioni su tutte le app che fanno parte di un singolo bundle di app attualmente presente nella coda di installazione. |
| AutoUpdateSetting |
Ottiene o imposta l'impostazione di aggiornamento automatico per le app nel computer o nel dispositivo corrente. |
| CanInstallForAllUsers |
Ottiene o imposta un valore che indica se l'app chiamante dispone di privilegi amministrativi elevati per garantire che l'installazione di un'app per tutti gli utenti abbia esito positivo. |
Metodi
| Nome | Descrizione |
|---|---|
| Cancel(String, String) |
Annulla l'installazione dell'app specificata, con l'opzione per generare dati di telemetria. |
| Cancel(String) |
Annulla l'installazione dell'app specificata. |
| GetFreeDeviceEntitlementAsync(String, String, String) |
Concede un diritto gratuito per l'app specificata a tutti gli utenti nel dispositivo corrente. |
| GetFreeUserEntitlementAsync(String, String, String) |
Concede un diritto gratuito per l'app specificata all'utente corrente. |
| GetFreeUserEntitlementForUserAsync(User, String, String, String) |
Concede un diritto gratuito per l'app specificata all'utente specificato. |
| GetIsAppAllowedToInstallAsync(String, String, String, String) |
Determina se l'app specificata dispone dell'autorizzazione per l'installazione nel computer o nel dispositivo corrente, con l'opzione per generare dati di telemetria. |
| GetIsAppAllowedToInstallAsync(String) |
Determina se l'app specificata dispone dell'autorizzazione per l'installazione nel computer o nel dispositivo corrente. |
| GetIsAppAllowedToInstallForUserAsync(User, String, String, String, String) |
Determina se l'app specificata dispone dell'autorizzazione per l'installazione nel computer o nel dispositivo corrente per l'utente specificato, con l'opzione per generare dati di telemetria. |
| GetIsApplicableAsync(String, String) |
Determina se l'app specificata può essere installata nel computer o nel dispositivo corrente. |
| GetIsApplicableForUserAsync(User, String, String) |
Determina se l'app specificata può essere installata nel computer o nel dispositivo corrente per l'utente specificato. |
| GetIsPackageIdentityAllowedToInstallAsync(String, String, String) |
Restituisce un valore che indica se il pacchetto con le informazioni di identità specificate può essere installato nel dispositivo corrente. |
| GetIsPackageIdentityAllowedToInstallForUserAsync(User, String, String, String) |
Restituisce un valore che indica se il pacchetto con le informazioni di identità specificate può essere installato nel dispositivo corrente per l'utente specificato. |
| IsStoreBlockedByPolicyAsync(String, String) |
Determina se l'app specificata è bloccata dai criteri nel computer o nel dispositivo corrente. |
| MoveToFrontOfDownloadQueue(String, String) |
Sposta l'app specificata all'inizio della coda di download. |
| Pause(String, String) |
Sospende l'installazione dell'app specificata, con l'opzione per generare dati di telemetria. |
| Pause(String) |
Sospende l'installazione dell'app specificata. |
| Restart(String, String) |
Riavvia l'installazione dell'app specificata, con l'opzione per generare dati di telemetria. |
| Restart(String) |
Riavvia l'installazione dell'app specificata. |
| SearchForAllUpdatesAsync() |
Cerca tutti gli aggiornamenti disponibili per le app installate nel computer o nel dispositivo corrente. |
| SearchForAllUpdatesAsync(String, String, AppUpdateOptions) |
Cerca tutti gli aggiornamenti disponibili per le app installate nel computer o nel dispositivo corrente, con la possibilità di consentire i riavvii forzati dell'app e l'opzione per generare dati di telemetria. |
| SearchForAllUpdatesAsync(String) |
Cerca tutti gli aggiornamenti disponibili per le app installate nel computer o nel dispositivo corrente, con l'opzione per generare dati di telemetria. |
| SearchForAllUpdatesForUserAsync(User, String, String, AppUpdateOptions) |
Cerca tutti gli aggiornamenti disponibili per le app installate nel computer o nel dispositivo corrente per l'utente specificato, con la possibilità di consentire i riavvii forzati dell'app e l'opzione per generare dati di telemetria. |
| SearchForAllUpdatesForUserAsync(User, String) |
Cerca tutti gli aggiornamenti disponibili per le app installate nel computer o nel dispositivo corrente per l'utente specificato, con l'opzione per generare dati di telemetria. |
| SearchForUpdatesAsync(String, String, String, String, AppUpdateOptions) |
Cerca gli aggiornamenti per l'app specificata, con la possibilità di consentire un riavvio forzato dell'app e l'opzione per generare i dati di telemetria. |
| SearchForUpdatesAsync(String, String, String, String) |
Cerca gli aggiornamenti per l'app specificata, con l'opzione per generare dati di telemetria. |
| SearchForUpdatesAsync(String, String) |
Cerca gli aggiornamenti per l'app specificata. |
| SearchForUpdatesForUserAsync(User, String, String, String, String, AppUpdateOptions) |
Cerca gli aggiornamenti per l'app e l'utente specificati, con la possibilità di consentire un riavvio forzato dell'app e l'opzione per generare dati di telemetria. |
| SearchForUpdatesForUserAsync(User, String, String, String, String) |
Cerca gli aggiornamenti per l'app e l'utente specificati, con l'opzione per generare dati di telemetria. |
| StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String) |
Annotazioni Si noti che il Avvia l'installazione dell'app specificata, con l'opzione per generare dati di telemetria. |
| StartAppInstallAsync(String, String, Boolean, Boolean) |
Annotazioni Si noti che il Avvia l'installazione dell'app specificata. |
| StartProductInstallAsync(String, String, String, String, AppInstallOptions) |
Avvia l'installazione dell'app o del bundle di app specificato, con la possibilità di specificare opzioni di installazione aggiuntive, ad esempio se consentire un riavvio forzato dell'app. Annotazioni Evitare di chiamare Le richieste di installazione effettuate prima del completamento della configurazione guidata potrebbero non comportarsi come previsto perché i servizi correlati allo Store potrebbero non essere ancora completamente inizializzati. Per ottenere risultati ottimali, chiamare questi metodi dopo il primo accesso dell'utente. |
| StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume) |
Avvia l'installazione dell'app o del bundle dell'app specificato. |
| StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions) |
Avvia l'installazione dell'app o del bundle di app specificato per l'utente specificato, con la possibilità di specificare opzioni di installazione aggiuntive, ad esempio se consentire un riavvio forzato dell'app. Annotazioni Evitare di chiamare Le richieste di installazione effettuate prima del completamento della configurazione guidata potrebbero non comportarsi come previsto perché i servizi correlati allo Store potrebbero non essere ancora completamente inizializzati. Per ottenere risultati ottimali, chiamare questi metodi dopo il primo accesso dell'utente. |
| StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume) |
Avvia l'installazione dell'app o del bundle dell'app specificato per l'utente specificato. |
| UpdateAppByPackageFamilyNameAsync(String, String) |
Avvia l'aggiornamento di un'app specificata dal nome della famiglia di pacchetti, con l'opzione per generare dati di telemetria. |
| UpdateAppByPackageFamilyNameAsync(String) |
Avvia l'aggiornamento di un'app specificata dal nome della famiglia di pacchetti. |
| UpdateAppByPackageFamilyNameForUserAsync(User, String, String) |
Avvia l'aggiornamento di un'app per un determinato utente specificato dal nome della famiglia di pacchetti, con l'opzione per generare dati di telemetria. |
Eventi
| Nome | Descrizione |
|---|---|
| ItemCompleted |
Si verifica al termine dell'installazione di un'app. |
| ItemStatusChanged |
Si verifica quando lo stato di un'app nella coda di installazione è stato modificato. |