DirectoryObjectSecurity.RemoveAccessRule(ObjectAccessRule) Method

Reference

Definition

Namespace:: System.Security.AccessControl

Assembly:: System.IO.FileSystem.AccessControl.dll

Assembly:: mscorlib.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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 DirectoryObjectSecurity object.

protected:
 bool RemoveAccessRule(System::Security::AccessControl::ObjectAccessRule ^ rule);

protected bool RemoveAccessRule (System.Security.AccessControl.ObjectAccessRule rule);

member this.RemoveAccessRule : System.Security.AccessControl.ObjectAccessRule -> bool

Protected Function RemoveAccessRule (rule As ObjectAccessRule) As Boolean

Parameters

rule: ObjectAccessRule

The access rule to remove.

Returns

Boolean

true if the access rule was successfully removed; otherwise, false.

Remarks

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.

Applies to