This documentation is archived and is not being maintained.

CommonObjectSecurity.RemoveAccessRule Method

Removes access rules that contain the same security identifier and access mask as the specified access rule from the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object.

Namespace:  System.Security.AccessControl
Assembly:  mscorlib (in mscorlib.dll)

protected bool RemoveAccessRule(
	AccessRule rule
)

Parameters

rule
Type: System.Security.AccessControl.AccessRule
The access rule to remove.

Return Value

Type: System.Boolean
true if the access rule was successfully removed; otherwise, false.

Access removal is accomplished by using a complex algorithm that might add access control rules in addition to removing them.

This method fails to remove the access rule and returns false if the inheritance rules associated with the access rule are too complex for the removal algorithm to succeed.

To avoid unintentionally allowing access to principals, applications should check for the existence of an allow everyone full access (AEFA) access control entry (ACE) and remove it before modifying a DACL.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: