PipeAuditRule Class

Definition

Represents an abstraction of an access control entry (ACE) that defines an audit rule for a pipe.

public sealed class PipeAuditRule : System.Security.AccessControl.AuditRule
Inheritance

Remarks

Audit rules determine when and how actions performed on system objects are logged.

The PipeAuditRule class represents an abstraction of an underlying access control entry (ACE) that specifies a user account, the type of access to provide (read, write, and so on), and whether to perform auditing. This class can specify how audit rules are inherited from and propagated to objects.

To allow file auditing on computers that are running Windows NT or later operating systems, the Audit Access Security policy must be enabled; by default, this policy is set to No Auditing.

To enable the Audit Access Security policy, perform the following steps:

  1. Click the Start button and then point to All Programs. Point to Administrative Tools and then click Local Security Policy.

  2. In the Local Security Settings window, expand the Local Policies folder and left-click the Audit Policy folder.

  3. Double-click the Audit object access entry in the right pane of the Local Security Settings window to display the Audit object access Properties dialog box.

  4. Select the Success or Failure boxes to log successes or failures.

Note that an audit rule for a user account requires a corresponding access rule for the same user account.

Use the PipeAuditRule class to create a new audit rule. You can persist this rule using the PipeSecurity class.

Constructors

PipeAuditRule(IdentityReference, PipeAccessRights, AuditFlags)

Initializes a new instance of the PipeAuditRule class for a user account specified in a IdentityReference object.

PipeAuditRule(String, PipeAccessRights, AuditFlags)

Initializes a new instance of the PipeAuditRule class for a named user account.

Properties

AccessMask

Gets the access mask for this rule.

(Inherited from AuthorizationRule)
AuditFlags

Gets the audit flags for this audit rule.

(Inherited from AuditRule)
IdentityReference

Gets the IdentityReference to which this rule applies.

(Inherited from AuthorizationRule)
InheritanceFlags

Gets the value of flags that determine how this rule is inherited by child objects.

(Inherited from AuthorizationRule)
IsInherited

Gets a value indicating whether this rule is explicitly set or is inherited from a parent container object.

(Inherited from AuthorizationRule)
PipeAccessRights

Gets the PipeAccessRights flags that are associated with the current PipeAuditRule object.

PropagationFlags

Gets the value of the propagation flags, which determine how inheritance of this rule is propagated to child objects. This property is significant only when the value of the InheritanceFlags enumeration is not None.

(Inherited from AuthorizationRule)

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

Product Versions
.NET Core 1.1, 6, 7, 8, 9
.NET Framework 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