Skip to content

Commit 806eecc

Browse files
authored
Merge pull request #5768 from MicrosoftDocs/drewbat/tyler-patch-build-fix
New PR to deal with a build error caused by an unrelated change in the repo
2 parents 519c10b + ea3433b commit 806eecc

1 file changed

Lines changed: 13 additions & 11 deletions

File tree

hub/apps/develop/windows-integration/default-apps-platform.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -10,21 +10,21 @@ ms.localizationpriority: medium
1010

1111
This article provides information for Windows app developers about how to integrate with the default apps platform on Windows and how to direct users to change the default app settings in Windows 11.
1212

13-
The app defaults platform on Windows supports two main scenarios:
13+
The app defaults platform enables developers to register their apps for supporting file and link types on Windows in support of two main scenarios:
1414

1515
* Allow users to specify which apps Windows uses to open specific file types or link types using the **Default apps** UX in **Settings**.
16-
* Allow apps to the use the default apps for files and link types in order to perform app-to-app launches.
16+
* Allow developers to facilitate app-to-app launches by invoking a file or link type.
1717

1818
## Default app experience for end users
1919

2020
Windows 11 allows users to change default apps via the Settings app and other system UI.
2121

22-
* Windows will automatically prompt the user when they open a file or link type when a new app is installed that registered for that link type.
22+
* Windows will automatically prompt the user when they open a file or link type when a new app is installed that registered for that file or link type.
2323
* Apps can also direct the user to Settings to change default app settings, guiding users through this process using in-app prompts or documentation.
2424

2525
## Default app settings for app developers
2626

27-
Your app can register to become the default handler for a file and link types. Both Windows desktop applications and Universal Windows Platform (UWP) apps can register to be a default handler. If the user chooses your app as the default handler, your app will be activated when that type of file is launched.
27+
Your app can register to become the default handler for a file and link types. Both Windows desktop applications and Universal Windows Platform (UWP) apps can register to be a default handler. If the user chooses your app as the default handler, Windows will activate your app when that type of file or link is invoked.
2828

2929
## Default apps platform best practices for developers
3030

@@ -46,7 +46,7 @@ URI schemes may be an official standard, documented publicly, or proprietary. Fo
4646

4747
* `https:` is documented as a Permanent scheme by the Internet Assigned Numbers Authority as RFC8615.
4848
* Spotify publicly documents a `spotify:` scheme, see [Spotify URIs and IDs](https://developer.spotify.com/documentation/web-api/concepts/spotify-uris-ids).
49-
* Other schemes may be proprietary and would create a broken end-to-end experience for the user if an app registers and is set for the default for a URI scheme it doesn’t know how to implement
49+
* Other schemes may be proprietary and would create a broken end-to-end experience for the user if an app registers and is set for the default for a URI scheme it doesn’t know how to implement.
5050

5151
## Register for file and link types
5252

@@ -58,14 +58,16 @@ When a Windows app is launched, Windows provides information to the app that all
5858

5959
## Security considerations for the app defaults platform
6060

61-
To help protect users, Windows requires that app default settings must be manually performed by the user through the Windows system UI. Features of this system include the following:
61+
To help protect users' default app choices from malware changing settings without the user being aware, Windows requires that app default settings must be set through the Windows system UI.
6262

63-
* Windows 11 does not allow programmatic changes to default apps without user interaction.
64-
* Apps can query which app is the default for a given type. For more information, see [IApplicationAssociationRegistration::QueryCurrentDefault](/windows/win32/api/shobjidl_core/nf-shobjidl_core-iapplicationassociationregistration-querycurrentdefault).
63+
* Windows does not allow programmatic changes to default apps without user interaction in system UI. For more information, see [App defaults in managed environments](#App_defaults_in_managed_environments)
6564
* User setting data for app defaults is obfuscated in registry data stores. Registry-based changes are not supported for apps.
66-
* User setting data for app defaults is protected by a Windows filter driver (UCPD.sys) that blocks apps from writing app defaults data.
67-
* Apps that are distributed by the Microsoft Store must abide by Microsoft Store policy, specifically [Section 10.2.8](/windows/apps/publish/store-policies#102-security) which requires that apps only use supported methods for updating Windows settings.
65+
* User setting data for app defaults are protected by a Windows filter driver (UCPD.sys) that blocks apps from writing app defaults data.
66+
* Apps can query which app is the default for a given type. For more information, see [IApplicationAssociationRegistration::QueryCurrentDefault](/windows/win32/api/shobjidl_core/nf-shobjidl_core-iapplicationassociationregistration-querycurrentdefault).
67+
* Apps that are distributed by the Microsoft Store must abide by Microsoft Store policy, specifically [Section 10.2.8](/windows/apps/publish/store-policies#102-security) which requires that apps only use supported methods for updating Windows settings, including app default settings.
68+
6869

6970
## App defaults in managed environments
7071

71-
The app defaults platform provides Group Policy and Mobile Device Management (MDM) policies to facilitate management scenarios. These policies also work with roaming user profiles to support more complex environments. Solutions that don’t use these policies may not work correctly because of the security considerations noted above. For more information, see [ApplicationDefaults Policy CSP](/windows/client-management/mdm/policy-csp-applicationdefaults) and [Deploy roaming user profiles](/windows-server/storage/folder-redirection/deploy-roaming-user-profiles)
72+
On a managed PC, IT admins can control app defaults through policy. The app defaults platform provides Group Policy and Mobile Device Management (MDM) policies to facilitate these management scenarios. These policies also work with roaming user profiles to support more complex environments. Solutions that don’t use these policies may not work correctly because of the security considerations noted above. For more information, see [ApplicationDefaults Policy CSP](/windows/client-management/mdm/policy-csp-applicationdefaults) and [Deploy roaming user profiles](/windows-server/storage/folder-redirection/deploy-roaming-user-profiles)
73+

0 commit comments

Comments
 (0)