FileSystemSecurity.RemoveAccessRuleAll(FileSystemAccessRule) Method

Definition

Removes all access control list (ACL) permissions for the specified user from the current file or directory.

public:
 void RemoveAccessRuleAll(System::Security::AccessControl::FileSystemAccessRule ^ rule);
public void RemoveAccessRuleAll (System.Security.AccessControl.FileSystemAccessRule rule);
override this.RemoveAccessRuleAll : System.Security.AccessControl.FileSystemAccessRule -> unit
Public Sub RemoveAccessRuleAll (rule As FileSystemAccessRule)

Parameters

rule
FileSystemAccessRule

A FileSystemAccessRule object that specifies a user whose access control list (ACL) permissions should be removed from a file or directory.

Exceptions

The rule parameter is null.

Remarks

The RemoveAccessRuleAll method removes all access control list (ACL) permissions for the specified user. The method ignores all values in the FileSystemAccessRule object except the user account.

To persist new or changed ACL information to a file, use the SetAccessControl or SetAccessControl method. To persist new or changed ACL information to a directory, use the SetAccessControl or SetAccessControl method.

To retrieve ACL information from a file, use the GetAccessControl or GetAccessControl method. To retrieve ACL information from a directory, use the GetAccessControl or GetAccessControl method.

When you add an access rule without setting the Synchronize flag, the Synchronize flag will be automatically added to your rule. If you remove the rule later without specifying the Synchronize flag, the flag will automatically be removed.

Applies to