ActiveDirectorySecurity.ResetAccessRule(ActiveDirectoryAccessRule) Method

Definition

Namespace:

System.DirectoryServices

Assembly:

System.DirectoryServices.dll

Package:

System.DirectoryServices v8.0.0

Source:

ActiveDirectorySecurity.cs

Searches an object's DACL for all access rules that contain a security identifier (SID) that matches the SID specified in the rule object, and replaces all of those access rules with the access rules that are contained in the rule object.

public:
 void ResetAccessRule(System::DirectoryServices::ActiveDirectoryAccessRule ^ rule);

public void ResetAccessRule (System.DirectoryServices.ActiveDirectoryAccessRule rule);

override this.ResetAccessRule : System.DirectoryServices.ActiveDirectoryAccessRule -> unit

Public Sub ResetAccessRule (rule As ActiveDirectoryAccessRule)

Parameters

rule

ActiveDirectoryAccessRule

The ActiveDirectoryAccessRule object to which this operation applies.

Remarks

When ResetAccessRule is used to replace all access rules with a particular SID in an object's DACL, both Allow- and Deny- type rules are replaced. To replace only Allow rules without affecting Deny rules, or to replace Deny rules without affecting Allow rules, use SetAccessRule instead.