Compartilhar via

Iniciar a página de configurações de Aplicativos Padrão

Saiba como iniciar as Configurações do Windows a partir do seu aplicativo para exibir a página de configurações de Aplicativos Padrão usando o esquema de URI ms-settings.

O Windows define um conjunto de URIs que permitem que os aplicativos iniciem as Configurações do Windows e exibam uma página de configurações específica. Este artigo explica como iniciar as Configurações do Windows diretamente na página de configurações de Aplicativos Padrão e, opcionalmente, navegar diretamente para as configurações de um aplicativo padrão especificado. Para obter mais informações, consulte Iniciar Configurações do Windows.

A URL de configurações de Aplicativos Padrão

ms-settings:defaultapps inicia as Configurações do Windows e navega até a página de configurações de Aplicativos Padrão. A partir do Windows 11, versão 21H2 (com Atualização Cumulativa 2023-04), 22H2 (com Atualização Cumulativa 2023-04) e 23H2 ou posterior, você pode acrescentar um parâmetro de cadeia de caracteres de consulta adicional no formato de URI de escape para iniciar diretamente na página de configurações de um aplicativo específico.

Há três parâmetros de cadeia de caracteres de consulta. O parâmetro de cadeia de caracteres de consulta a ser usado depende de como o aplicativo foi instalado.

Parâmetro de string de consulta Valor a ser passado
usuárioRegistradoDoApp Valor nomeado de HKEY_CURRENT_USER\Software\RegisteredApplications

Utilize quando o aplicativo foi instalado por usuário individual e o registro do aplicativo foi feito no HKEY_CURRENT_USER\Software\RegisteredApplications.
máquinaDeAplicativoRegistrado Valor nomeado de HKEY_LOCAL_MACHINE\Software\RegisteredApplications

Use quando o aplicativo foi instalado em cada máquina e o registro do aplicativo foi gravado em HKEY_LOCAL_MACHINE\Software\RegisteredApplications.
registeredAUMID ID do modelo de usuário do aplicativo

Use quando o aplicativo foi registrado no Gerenciador de Pacotes usando um manifesto declarando que o aplicativo manipula tipos de arquivo (uap:FileTypeAssociation) ou esquemas de URI (uap:Protocol).

Nota

Para que o parâmetro de cadeia de caracteres de consulta registeredAUMID funcione após uma atualização do sistema operacional, talvez seja necessário incrementar o valor TargetDeviceFamily...MaxVersionTested no seu manifesto. Isso garantirá que o aplicativo seja reindexado para o usuário, que, por sua vez, atualizará as definições apropriadas usadas para processar o link profundo por meio da ativação do protocolo. MaxVersionTested deve ser atualizado para 10.0.22000.1817 para Windows 11, versão 21H2 ou 10.0.22621.1555 para Windows 11, versão 22H2.

No exemplo a seguir, LaunchUriAsync é chamado para iniciar as Configurações do Windows. O Uri do ms-settings:defaultapps especifica que a página de configurações de Aplicativos padrão deve ser exibida. Em seguida, o aplicativo que deve ser iniciado é determinado. Como exemplo, "Microsoft Edge" foi registrado pelo aplicativo em HKEY_LOCAL_MACHINE\Software\RegisteredApplications. Como é um aplicativo instalado por computador, registeredAppMachine é o parâmetro de cadeia de caracteres de consulta que deve ser usado. O parâmetro opcional de cadeia de caracteres de consulta registeredAppMachine é definido como o nome registrado, escapado por meio de uma chamada para Url.EscapeDataString, para especificar que a página do Microsoft Edge deve ser exibida.

private async void LaunchSettingsPage_Click(object sender, RoutedEventArgs e)
{
    bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:defaultapps?registeredAppMachine=" + Uri.EscapeDataString("Microsoft Edge")));
}

bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:defaultapps?registeredAppMachine=" + Uri::EscapeDataString(L"Microsoft Edge")));

Conteúdo relacionado

Iniciar configurações do Windows

iniciar o aplicativo padrão para um URI específico

  • Last updated on