Edit

Share via


RegistrySecurity.AddAuditRule(RegistryAuditRule) Method

Definition

Searches for an audit rule with which the new rule can be merged. If none are found, adds the new rule.

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

Parameters

rule
RegistryAuditRule

The audit rule to add. The user specified by this rule determines the search.

Remarks

The AddAuditRule method searches for rules with the same user or group as rule. If none are found, rule is added. If a matching rule is found, the flags in rule are merged into the existing rule.

Rules cannot be merged if they have different inheritance flags. For example, if failed attempts to write to a key are audited for a particular user, with no inheritance flags, and AddAuditRule is used to add a rule specifying that failed attempts to change permissions are to be audited for the same user, but with inheritance for subkeys (InheritanceFlags.ContainerInherit), the two rules cannot be merged.

Applies to