AppInstallManager Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece membros para instalar aplicativos programaticamente, incluindo a capacidade de iniciar uma instalação de aplicativo e obter uma lista de instalações de aplicativo em andamento no momento.
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 AppInstallManager
function AppInstallManager()
Public NotInheritable Class AppInstallManager
- Herança
- Atributos
Requisitos do Windows
| Requisitos | Description |
|---|---|
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
| Funcionalidades do aplicativo |
runFullTrust
|
Comentários
Importante
O acesso a essa API é protegido por uma funcionalidade privada restrita a aplicativos desenvolvidos por Microsoft.
Observação
Evite chamar AppInstallManager.StartProductInstallAsync ou AppInstallManager.StartProductInstallForUserAsync durante o OOBE (Windows Out of Box Experience).
As solicitações de instalação feitas antes da conclusão do OOBE podem não se comportar conforme o esperado porque os serviços relacionados à Loja ainda podem não estar totalmente inicializados.
Para obter melhores resultados, chame esses métodos após a primeira entrada do usuário.
Histórico de versões
| Windows versão | Versão do SDK | Valor adicionado |
|---|---|---|
| 1511 | 10586 | Cancel(String,String) |
| 1511 | 10586 | GetIsAppAllowedToInstallAsync(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, 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) |
| 1607 | 14393 | StartProductInstallAsync(String, String,String,String,Boolean,Boolean,String,PackageVolume) |
| 1607 | 14393 | StartProductInstallForUserAsync(User, 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, String, AppUpdateOptions) |
| 1803 | 17134 | SearchForUpdatesForUserAsync(User, String, String, String, String, AppUpdateOptions) |
| 1803 | 17134 | StartProductInstallAsync(String, String, String, String, AppInstallOptions) |
| 1803 | 17134 | StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions) |
| 1809 | 17763 | CanInstallForAllUsers |
Construtores
| Nome | Description |
|---|---|
| AppInstallManager() |
Cria e inicializa uma nova instância da classe AppInstallManager . |
Propriedades
| Nome | Description |
|---|---|
| AcquisitionIdentity |
Obtém ou define a identidade do usuário associada às instalações do aplicativo. |
| AppInstallItems |
Recupera informações sobre todos os aplicativos que estão atualmente na fila de instalação. |
| AppInstallItemsWithGroupSupport |
Recupera informações sobre todos os aplicativos que fazem parte de um único pacote de aplicativos que está atualmente na fila de instalação. |
| AutoUpdateSetting |
Obtém ou define a configuração de atualização automática para aplicativos no computador ou dispositivo atual. |
| CanInstallForAllUsers |
Obtém ou define um valor que indica se o aplicativo de chamada tem privilégios administrativos elevados para garantir que a instalação de um aplicativo para todos os usuários seja bem-sucedida. |
Métodos
| Nome | Description |
|---|---|
| Cancel(String, String) |
Cancela a instalação do aplicativo especificado, com a opção de gerar dados de telemetria. |
| Cancel(String) |
Cancela a instalação do aplicativo especificado. |
| GetFreeDeviceEntitlementAsync(String, String, String) |
Concede um direito gratuito para o aplicativo especificado a todos os usuários no dispositivo atual. |
| GetFreeUserEntitlementAsync(String, String, String) |
Concede um direito gratuito para o aplicativo especificado ao usuário atual. |
| GetFreeUserEntitlementForUserAsync(User, String, String, String) |
Concede um direito gratuito para o aplicativo especificado ao usuário especificado. |
| GetIsAppAllowedToInstallAsync(String, String, String, String) |
Determina se o aplicativo especificado tem permissão para instalar no computador ou dispositivo atual, com a opção de gerar dados de telemetria. |
| GetIsAppAllowedToInstallAsync(String) |
Determina se o aplicativo especificado tem permissão para instalar no computador ou dispositivo atual. |
| GetIsAppAllowedToInstallForUserAsync(User, String, String, String, String) |
Determina se o aplicativo especificado tem permissão para instalar no computador ou dispositivo atual para o usuário especificado, com a opção de gerar dados de telemetria. |
| GetIsApplicableAsync(String, String) |
Determina se o aplicativo especificado pode ser instalado no computador ou dispositivo atual. |
| GetIsApplicableForUserAsync(User, String, String) |
Determina se o aplicativo especificado pode ser instalado no computador ou dispositivo atual para o usuário especificado. |
| GetIsPackageIdentityAllowedToInstallAsync(String, String, String) |
Retorna um valor que indica se o pacote com as informações de identidade especificadas tem permissão para ser instalado no dispositivo atual. |
| GetIsPackageIdentityAllowedToInstallForUserAsync(User, String, String, String) |
Retorna um valor que indica se o pacote com as informações de identidade especificadas tem permissão para ser instalado no dispositivo atual para o usuário especificado. |
| IsStoreBlockedByPolicyAsync(String, String) |
Determina se o aplicativo especificado está bloqueado pela política no computador ou dispositivo atual. |
| MoveToFrontOfDownloadQueue(String, String) |
Move o aplicativo especificado para a frente da fila de download. |
| Pause(String, String) |
Pausa a instalação do aplicativo especificado, com a opção de gerar dados de telemetria. |
| Pause(String) |
Pausa a instalação do aplicativo especificado. |
| Restart(String, String) |
Reinicia a instalação do aplicativo especificado, com a opção de gerar dados de telemetria. |
| Restart(String) |
Reinicia a instalação do aplicativo especificado. |
| SearchForAllUpdatesAsync() |
Pesquisa todas as atualizações disponíveis para aplicativos instalados no computador ou dispositivo atual. |
| SearchForAllUpdatesAsync(String, String, AppUpdateOptions) |
Pesquisa todas as atualizações disponíveis para aplicativos instalados no computador ou dispositivo atual, com a capacidade de permitir reinicializações forçadas do aplicativo e a opção de gerar dados de telemetria. |
| SearchForAllUpdatesAsync(String) |
Pesquisa todas as atualizações disponíveis para aplicativos instalados no computador ou dispositivo atual, com a opção de gerar dados de telemetria. |
| SearchForAllUpdatesForUserAsync(User, String, String, AppUpdateOptions) |
Pesquisa todas as atualizações disponíveis para aplicativos instalados no computador ou dispositivo atual para o usuário especificado, com a capacidade de permitir reinicializações forçadas do aplicativo e a opção de gerar dados de telemetria. |
| SearchForAllUpdatesForUserAsync(User, String) |
Pesquisa todas as atualizações disponíveis para aplicativos instalados no computador ou dispositivo atual para o usuário especificado, com a opção de gerar dados de telemetria. |
| SearchForUpdatesAsync(String, String, String, String, AppUpdateOptions) |
Pesquisa atualizações para o aplicativo especificado, com a capacidade de permitir uma reinicialização forçada do aplicativo e a opção de gerar dados de telemetria. |
| SearchForUpdatesAsync(String, String, String, String) |
Pesquisa atualizações para o aplicativo especificado, com a opção de gerar dados de telemetria. |
| SearchForUpdatesAsync(String, String) |
Pesquisa atualizações para o aplicativo especificado. |
| SearchForUpdatesForUserAsync(User, String, String, String, String, AppUpdateOptions) |
Pesquisa atualizações para o aplicativo e o usuário especificados, com a capacidade de permitir uma reinicialização forçada do aplicativo e a opção de gerar dados de telemetria. |
| SearchForUpdatesForUserAsync(User, String, String, String, String) |
Pesquisa atualizações para o aplicativo e o usuário especificados, com a opção de gerar dados de telemetria. |
| StartAppInstallAsync(String, String, Boolean, Boolean, String, String, String) |
Observação Observe que o Inicia a instalação do aplicativo especificado, com a opção de gerar dados de telemetria. |
| StartAppInstallAsync(String, String, Boolean, Boolean) |
Observação Observe que o Inicia a instalação do aplicativo especificado. |
| StartProductInstallAsync(String, String, String, String, AppInstallOptions) |
Inicia a instalação do aplicativo ou do pacote de aplicativos especificado, com a capacidade de especificar opções de instalação adicionais, como permitir uma reinicialização forçada do aplicativo. Observação Evite chamar As solicitações de instalação feitas antes da conclusão do OOBE podem não se comportar conforme o esperado porque os serviços relacionados à Loja ainda podem não estar totalmente inicializados. Para obter melhores resultados, chame esses métodos após a primeira entrada do usuário. |
| StartProductInstallAsync(String, String, String, String, Boolean, Boolean, String, PackageVolume) |
Inicia a instalação do aplicativo ou pacote de aplicativos especificado. |
| StartProductInstallForUserAsync(User, String, String, String, String, AppInstallOptions) |
Inicia a instalação do aplicativo ou pacote de aplicativos especificado para o usuário especificado, com a capacidade de especificar opções de instalação adicionais, como permitir uma reinicialização forçada do aplicativo. Observação Evite chamar As solicitações de instalação feitas antes da conclusão do OOBE podem não se comportar conforme o esperado porque os serviços relacionados à Loja ainda podem não estar totalmente inicializados. Para obter melhores resultados, chame esses métodos após a primeira entrada do usuário. |
| StartProductInstallForUserAsync(User, String, String, String, String, Boolean, Boolean, String, PackageVolume) |
Inicia a instalação do aplicativo ou pacote de aplicativos especificado para o usuário especificado. |
| UpdateAppByPackageFamilyNameAsync(String, String) |
Inicia a atualização de um aplicativo especificado pelo nome da família de pacotes, com a opção de gerar dados de telemetria. |
| UpdateAppByPackageFamilyNameAsync(String) |
Inicia a atualização de um aplicativo especificado pelo nome da família de pacotes. |
| UpdateAppByPackageFamilyNameForUserAsync(User, String, String) |
Inicia a atualização de um aplicativo para um determinado usuário especificado pelo nome da família de pacotes, com a opção de gerar dados de telemetria. |
Eventos
| Nome | Description |
|---|---|
| ItemCompleted |
Ocorre quando um aplicativo termina de instalar. |
| ItemStatusChanged |
Ocorre quando o status de um aplicativo na fila de instalação é alterado. |