ObjectSecurity.ModifyAccessRule Method

Reference

Definition

Namespace:: System.Security.AccessControl

Assembly:: System.Security.AccessControl.dll

Assembly:: mscorlib.dll

Package:: System.Security.AccessControl v6.0.1

Source:: ObjectSecurity.cs

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.

Applies the specified modification to the Discretionary Access Control List (DACL) associated with this ObjectSecurity object.

public:
 virtual bool ModifyAccessRule(System::Security::AccessControl::AccessControlModification modification, System::Security::AccessControl::AccessRule ^ rule, [Runtime::InteropServices::Out] bool % modified);

public virtual bool ModifyAccessRule(System.Security.AccessControl.AccessControlModification modification, System.Security.AccessControl.AccessRule rule, out bool modified);

abstract member ModifyAccessRule : System.Security.AccessControl.AccessControlModification * System.Security.AccessControl.AccessRule * bool -> bool
override this.ModifyAccessRule : System.Security.AccessControl.AccessControlModification * System.Security.AccessControl.AccessRule * bool -> bool

Public Overridable Function ModifyAccessRule (modification As AccessControlModification, rule As AccessRule, ByRef modified As Boolean) As Boolean

Parameters

modification: AccessControlModification

The modification to apply to the DACL.

rule: AccessRule

The access rule to modify.

modified: Boolean

true if the DACL is actually modified; otherwise, false.

Returns

Boolean

true if the DACL is successfully modified; otherwise, false.

Remarks

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.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, 6 (package-provided), 6, 7 (package-provided), 7, 8 (package-provided), 8, 9 (package-provided), 9, 10 (package-provided), 10
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)
Windows Desktop	3.0, 3.1, 5

Share via