Difference between revisions of "Controlled Folder Access"

From Nexus Mods Wiki
Jump to: navigation, search
m (How fix the problem)
m
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
A new version of this guide is available here: https://modding.wiki/en/vortex/users/controlled-folder-access
 +
 
Controlled Folder Access is a ransomware protection service part of Microsoft's Windows Defender security suite for Windows 10. This service blocks applications from making changes to certain protected folder paths on your PC. While it is disabled by default, enabling this feature without adding your games and apps (such as Vortex) to the "Allowed apps" list will prevent them from functioning correctly and report errors when trying to write to files in these folders.
 
Controlled Folder Access is a ransomware protection service part of Microsoft's Windows Defender security suite for Windows 10. This service blocks applications from making changes to certain protected folder paths on your PC. While it is disabled by default, enabling this feature without adding your games and apps (such as Vortex) to the "Allowed apps" list will prevent them from functioning correctly and report errors when trying to write to files in these folders.
  
Line 45: Line 47:
 
From here you have two options.
 
From here you have two options.
  
=== Option 1: Turning off Controlled folder access ===
 
In the "Ransomware protection" window, flick the "Controlled folder access" switch to the "Off" position. You will have to accept the Windows security prompt to confirm the change.
 
  
[[File:CFAGuide5.PNG|none|300px|thumb|Turn off Controlled folder access.]]
+
=== Option 1 - Turning off Controlled folder access ===
 +
 
 +
In the "Ransomware protection" window, flick the "Controlled folder access" switch to the "Off" position. You will have to accept the Windows security prompt to confirm the change.
  
 +
[[File:CFAGuide5.PNG|thumb|none|300px|Turn off Controlled folder access.]]
  
You may need to restart any apps or games that are currently running to reflect the changes.  
+
You may need to restart any apps or games that are currently running to reflect the changes.
  
=== Option 2: Adding an application ===
+
=== Option 2 - Adding an application ===
 
With "Controlled folder access" set to "On", you will see two options below the switch. "Protected folders" and "Allow an app through controlled folder access".  
 
With "Controlled folder access" set to "On", you will see two options below the switch. "Protected folders" and "Allow an app through controlled folder access".  
  
Line 69: Line 72:
 
You may need to restart the app or game to reflect the updated settings.
 
You may need to restart the app or game to reflect the updated settings.
  
== For Developers: How to detect if Controlled folder access is active ==
+
== For Developers - How to detect if Controlled folder access is active ==
  
 
If you are developing an app or game that uses the folders protected by Controlled folder access, you can detect the status of this feature in the registry.
 
If you are developing an app or game that uses the folders protected by Controlled folder access, you can detect the status of this feature in the registry.

Revision as of 15:38, 8 March 2022

A new version of this guide is available here: https://modding.wiki/en/vortex/users/controlled-folder-access

Controlled Folder Access is a ransomware protection service part of Microsoft's Windows Defender security suite for Windows 10. This service blocks applications from making changes to certain protected folder paths on your PC. While it is disabled by default, enabling this feature without adding your games and apps (such as Vortex) to the "Allowed apps" list will prevent them from functioning correctly and report errors when trying to write to files in these folders.

What problems can Controlled Folder Access cause?

With this feature enabled, Windows Defender will prevent programs from making changes to the user profile files and folders (Documents, Pictures, Videos, Music, Desktop, etc). This can be problematic when using games or mods as a lot of popular applications store configuration settings, save games and more in the "Documents" folder of the user's profile.

When an application attempts to write to these files it will be met with an "access denied" error similar to the ones shown below.


In the case of games, this will often fail silently so you will only see the problem when your progress is lost or your new configuration settings have not been applied.

This feature causes problems with Vortex's deployment when the game has configuration or mod files stored in the user's documents folder. It has also been reported to interfere with xEdit and could have a wider impact on modding tools.


Note: This protection also blocks Microsoft apps such as Snipping Tool, Paint, etc.

How to fix the problem

When it comes to fixing this problem, there are two solutions; turning off Controlled File Access or adding your apps/games to the allowed apps listing in Windows Defender.

To find the options for this feature, you will need to open Windows Settings by clicking the "Settings" gear above the power button in the Start Menu.

Settings button in the Start menu.


Next, select "Update & Security" and in the left menu choose "Windows Security".


Click "Virus & threat protection", then at the bottom of that page select "Manage Ransomware Protection".

Select "Manage Ransomware Protection".


From here you have two options.


Option 1 - Turning off Controlled folder access

In the "Ransomware protection" window, flick the "Controlled folder access" switch to the "Off" position. You will have to accept the Windows security prompt to confirm the change.

Turn off Controlled folder access.

You may need to restart any apps or games that are currently running to reflect the changes.

Option 2 - Adding an application

With "Controlled folder access" set to "On", you will see two options below the switch. "Protected folders" and "Allow an app through controlled folder access".


Select "Allow an app through controlled folder access", then accept the Windows security prompt.

Allow an app through controlled folder access.


Click "Add an allowed app" and choose "Browse all apps". You will then need to locate the EXE file for the app or game you are trying to unblock. e.g. Vortex's default install location would be C:\Program Files\Black Tree Gaming Ltd\Vortex\Vortex.exe

Add an allowed app.


You may need to restart the app or game to reflect the updated settings.

For Developers - How to detect if Controlled folder access is active

If you are developing an app or game that uses the folders protected by Controlled folder access, you can detect the status of this feature in the registry.


In order to detect if the feature is enabled, you need to check HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Defender\Exploit Guard\Controlled Folder Access the REG_DWORD "EnableControlledFolderAccess" reflects the enable state.


The feature protects the following folders by default:

%USERPROFILE%\Desktop
%USERPROFILE%\Documents
%USERPROFILE%\Pictures
%USERPROFILE%\Videos
%USERPROFILE%\Music
%USERPROFILE%\Favorites


If you wish to check for any custom folders the user is currently protecting, you can check HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Defender\Windows Defender Exploit Guard\Controlled Folder Access\ProtectedFolders in the registry.