Merge pull request #3461 from MicrosoftDocs/alvinashcraft/main-update-defaultsettings-app

Add new Launch Default Apps settings topic

Author: alvinashcraft

uwp/develop/toc.yml

@@ -1365,6 +1365,8 @@
               href: ../launch-resume/launch-ringtone-picker.md
             - name: Launch the Windows Settings app
               href: ../launch-resume/launch-settings-app.md
+            - name: Launch the Default Apps settings page
+              href: ../launch-resume/launch-default-apps-settings.md
             - name: Launch the Microsoft Store app
               href: ../launch-resume/launch-store-app.md
             - name: Launch the Windows Maps app

uwp/launch-resume/launch-default-apps-settings.md

@@ -0,0 +1,52 @@
+---
+title: Launch the Default Apps settings page
+description: Learn how to launch the Windows Settings app to display the Default Apps settings page from your app using the ms-settings URI scheme.
+ms.assetid: a1819f4b-af98-4366-b2de-a7aea26da3a9
+ms.date: 03/21/2023
+ms.topic: article
+keywords: windows, windows 11, uwp, default apps, windows app sdk
+ms.localizationpriority: medium
+dev_langs:
+  - csharp
+  - cppwinrt
+---
+
+# Launch the Default Apps settings page
+
+Learn how to launch the Windows Settings app to display the Default Apps settings page from your app using the ms-settings URI scheme.
+
+Windows defines a set of URIs that allow apps to launch the Windows Settings app and display a particular settings page. This article explains how to launch the Windows Settings app directly to the Default Apps settings page and, optionally, navigate directly to the settings for a specified default application. For more information, see [Launch the Windows Settings app](launch-settings-app.md).
+
+## The Default Apps settings URL
+
+ms-settings:defaultapps launches the Windows Settings app and navigates to the Default Apps settings page. Starting with Windows 11, version 21H2 (with 2023-04 Cumulative Update) or 22H2 (with 2023-04 Cumulative Update), you can append an additional query string parameter in escaped URI format to launch directly to the settings page for a specific application.
+
+There are three query string parameters. The query string parameter to be used depends on how the application was installed.
+
+| Query string parameter | Value to pass |
+|--------|--------|--------|
+| registeredAppUser | Named value from HKEY_CURRENT_USER\Software\RegisteredApplications<br/><br/>Use when the app was installed per user, and the registration for the app was written to HKEY_CURRENT_USER\Software\RegisteredApplications. |
+| registeredAppMachine | Named value from HKEY_LOCAL_MACHINE\Software\RegisteredApplications<br/><br/>Use when the app was installed per machine, and the registration for the app was written to HKEY_LOCAL_MACHINE\Software\RegisteredApplications. |
+| registeredAUMID | Application User Model ID <br/><br/>Use when the app was registered with Package Manager using a manifest declaring that the app handles File Types ([uap:FileTypeAssociation](/uwp/schemas/appxpackage/uapmanifestschema/element-uap-filetypeassociation)) or URI schemes ([uap:Protocol](/uwp/schemas/appxpackage/uapmanifestschema/element-uap-protocol)). |
+
+>[!NOTE]
+>To get the registeredAUMID query string parameter to work after an OS upgrade, an app may need to increment its TargetDeviceFamily...MaxVersionTested value in its manifest. This will ensure that the app is reindexed for the user, which in turn will update the appropriate definitions used to process the deep link via protocol activation. MaxVersionTested should be updated to `10.0.22000.1817` for Windows 11, version 21H2 or `10.0.22621.1555` for Windows 11, version 22H2.
+
+In the following example, `LaunchUriAsync` is called to launch the Windows Settings app. The ms-settings:defaultapps Uri specifies that the Default Apps settings page should be shown. Next, the app that should be launched is determined. As an example, “Microsoft Edge” was registered by the app in HKEY_LOCAL_MACHINE\Software\RegisteredApplications. Since it is a per machine installed app, `registeredAppMachine` is the query string parameter that should be used. The optional query string parameter `registeredAppMachine` is set to the registered name, escaped with a call to `Url.EscapeDataString`, to specify that the page for **Microsoft Edge** should be shown.
+
+```csharp
+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")));
+}
+```
+
+```cppwinrt
+bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:defaultapps?registeredAppMachine=" + Uri::EscapeDataString(L"Microsoft Edge")));
+```
+
+## See also
+
+[Launch the Windows Settings app](launch-settings-app.md)
+
+[Launch the default app for a URI](launch-default-app.md)

uwp/launch-resume/launch-settings-app.md

@@ -2,7 +2,7 @@
 title: Launch the Windows Settings app
 description: Learn how to launch the Windows Settings app from your app using the ms-settings URI scheme.
 ms.assetid: C84D4BEE-1FEE-4648-AD7D-8321EAC70290
-ms.date: 07/11/2022
+ms.date: 03/21/2023
 ms.topic: article
 keywords: windows 10, uwp
 ms.localizationpriority: medium
@@ -20,7 +20,7 @@ dev_langs:
 - [**PreferredApplicationPackageFamilyName**](/uwp/api/windows.system.launcheroptions.preferredapplicationpackagefamilyname)
 - [**DesiredRemainingView**](/uwp/api/windows.system.launcheroptions.desiredremainingview)
 
-Learn how to launch the Windows Settings app. This topic describes the **ms-settings:** URI scheme. Use this URI scheme to launch the Windows Settings app to specific settings pages.
+Learn how to launch the Windows Settings app. This topic describes the `ms-settings:` URI scheme. Use this URI scheme to launch the Windows Settings app to specific settings pages.
 
 Launching to the Settings app is an important part of writing a privacy-aware app. If your app can't access a sensitive resource, we recommend providing the user a convenient link to the privacy settings for that resource. For more info, see [Guidelines for privacy-aware apps](../security/index.md).
 
@@ -75,7 +75,6 @@ The following sections describe different categories of ms-settings URIs used to
 - [Extras](#extras)
 - [Family Group](#family-group)
 - [Gaming](#gaming)
-- [Home page](#home-page)
 - [Mixed reality](#mixed-reality)
 - [Network and internet](#network-and-internet)
 - [Personalization](#personalization)
@@ -125,9 +124,10 @@ The following sections describe different categories of ms-settings URIs used to
 |Settings page| URI |
 |-------------|-----|
 | Apps & Features | ms-settings:appsfeatures |
-| App features | ms-settings:appsfeatures-app (Reset, manage add-on & downloadable content, etc. for the app) <br><br> To access this page with a URI, use the `ms-settings:appsfeatures-app` URI and pass an optional parameter of the _package family name_ of the app. |
+| App features | ms-settings:appsfeatures-app (Reset, manage add-on & downloadable content, etc. for the app) <br><br> To access this page with a URI, use the ms-settings:appsfeatures-app URI and pass an optional parameter of the _package family name_ of the app. |
 | Apps for websites | ms-settings:appsforwebsites |
-| Default apps | ms-settings:defaultapps |
+| Default apps | ms-settings:defaultapps (**Behavior introduced in Windows 11, version 21H2 (with 2023-04 Cumulative Update) or 22H2 (with 2023-04 Cumulative Update), or later.**)<br/>Append the query string parameter in the following formats using the Uri-escaped name of an app to directly launch the default settings page for that app:<br/><br/>- registeredAppMachine=\<Uri-escaped per machine installed name of app\><br/>- registeredAppUser=\<Uri-escaped per user installed name of app\><br/>- registeredAUMID=\<Uri-escaped Application User Model ID\><br/><br/>For more information, see [Launch the Default Apps settings page](launch-default-apps-settings.md). |
+| Default browser settings | ms-settings:defaultbrowsersettings (**Deprecated in Windows 11**) |
 | Manage optional features | ms-settings:optionalfeatures |
 | Offline Maps | ms-settings:maps<br/>ms-settings:maps-downloadmaps (Download maps) |
 | Startup apps | ms-settings:startupapps |
@@ -166,7 +166,7 @@ The following sections describe different categories of ms-settings URIs used to
 | Printers & scanners | ms-settings:printers |
 | Touch | ms-settings:devices-touch |
 | Touchpad | ms-settings:devices-touchpad (only available if touchpad hardware is present) |
-| Text Suggestions | ms-settings:devicestyping-hwkbtextsuggestions)
+| Text Suggestions | ms-settings:devicestyping-hwkbtextsuggestions |
 | Typing | ms-settings:typing |
 | USB | ms-settings:usb |
 | Wheel | ms-settings:wheel (only available if Dial is paired) |
@@ -214,12 +214,6 @@ The following sections describe different categories of ms-settings URIs used to
 | Playing a game full screen | ms-settings:quietmomentsgame |
 | TruePlay | ms-settings:gaming-trueplay (**As of Windows 10, version 1809 (10.0; Build 17763), this feature is removed from Windows**) |
 
-### Home page
-
-|Settings page| URI |
-|-------------|-----|
-| Default browser settings | ms-settings:defaultbrowsersettings |
-
 ### Mixed reality
 
 > [!NOTE]
@@ -415,4 +409,8 @@ The following sections describe different categories of ms-settings URIs used to
 | Provisioning | ms-settings:workplace-provisioning (only available if enterprise has deployed a provisioning package) |
 | Repair token | ms-settings:workplace-repairtoken |
 | Provisioning | ms-settings:provisioning (only available on mobile and if the enterprise has deployed a provisioning package) |
-| Windows Anywhere | ms-settings:windowsanywhere (device must be Windows Anywhere-capable) |
+| Windows Anywhere | ms-settings:windowsanywhere (device must be Windows Anywhere-capable) |
+
+## See also
+
+[Launch the default app for a URI](launch-default-app.md)