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

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

O Windows define um conjunto de URIs que permitem que os aplicativos iniciem o aplicativo Configurações do Windows e exibam uma página de configurações específica. Este artigo explica como iniciar o aplicativo Configurações do Windows diretamente na página 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 o aplicativo Configurações do Windows.

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

ms-settings:defaultapps inicia o aplicativo Configurações do Windows e navega até a página Configurações de Aplicativos Padrão. Começando com Windows 11, versão 21H2 (com Atualização Cumulativa 2023-04) ou 22H2 (com Atualização Cumulativa 2023-04), 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 cadeia de caracteres de consulta	Valor a ser passado
registeredAppUser	Valor nomeado de HKEY_CURRENT_USER\Software\RegisteredApplications Use quando o aplicativo foi instalado por usuário e o registro do aplicativo foi gravado em HKEY_CURRENT_USER\Software\RegisteredApplications.
registeredAppMachine	Valor nomeado de HKEY_LOCAL_MACHINE\Software\RegisteredApplications Use quando o aplicativo foi instalado por computador 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).

Observação

Para que o parâmetro de cadeia de caracteres de consulta registeredAUMID funcione após uma atualização do sistema operacional, um aplicativo pode precisar incrementar seu TargetDeviceFamily... Valor MaxVersionTested em 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 o aplicativo Configurações do Windows. O Uri ms-settings:defaultapps especifica que a página configurações de Aplicativos Padrão deve ser mostrada. Em seguida, o aplicativo que deve ser iniciado é determinado. Por exemplo, "Microsoft Edge" foi registrado pelo aplicativo no 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 registeredAppMachine de cadeia de caracteres de consulta opcional é definido como o nome registrado, escapado com uma chamada para Url.EscapeDataString, para especificar que a página do Microsoft Edge deve ser mostrada.

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")));

Confira também

Iniciar o app Configurações do Windows

Iniciar o app padrão para um URI