PipeAuditRule Class

Reference

Definition

Namespace:: System.IO.Pipes

Assembly:: System.IO.Pipes.AccessControl.dll

Assembly:: System.Core.dll

Package:: System.IO.Pipes.AccessControl v5.0.0

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.

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

public ref class PipeAuditRule sealed : System::Security::AccessControl::AuditRule

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

type PipeAuditRule = class
    inherit AuditRule

Public NotInheritable Class PipeAuditRule
Inherits AuditRule

Inheritance: Object

AuthorizationRule

AuditRule
PipeAuditRule

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:

Click the Start button and then point to All Programs. Point to Administrative Tools and then click Local Security Policy.
In the Local Security Settings window, expand the Local Policies folder and left-click the Audit Policy folder.
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.
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

Jaa