System.IO.Pipes.PipeSecurity Class

Represents the access control and audit security for a pipe.

See Also: PipeSecurity Members

Syntax

public class PipeSecurity : System.Security.AccessControl.NativeObjectSecurity

Remarks

The System.IO.Pipes.PipeSecurity class specifies the access rights for a pipe and how access attempts are audited. This class represents access and audit rights as a set of rules. Each access rule is represented by a System.IO.Pipes.PipeAccessRule object, while each audit rule is represented by a System.IO.Pipes.PipeAuditRule object.

The System.IO.Pipes.PipeSecurity class is an abstraction of the underlying Microsoft Windows file security system. In this system, each pipe has a discretionary access control list (DACL), which controls access to the pipe, and a system access control list (SACL), which specifies the access control attempts that are audited. The System.IO.Pipes.PipeAccessRule and System.IO.Pipes.PipeAuditRule classes are abstractions of the access control entries (ACEs) that comprise DACLs and SACLs.

The System.IO.Pipes.PipeSecurity class hides many of the details of DACLs and SACLs; you do not have to worry about ACE ordering or null DACLS.

Use the System.IO.Pipes.PipeSecurity class to retrieve, add, or change the access rules that represent the DACL and SACL of a pipe.

To persist new or changed access or audit rules to a pipe, use the PipeStream.SetAccessControl(PipeSecurity) method. To retrieve access or audit rules from an existing file, use the PipeStream.GetAccessControl method.

Requirements

Namespace: System.IO.Pipes
Assembly: System.Core (in System.Core.dll)
Assembly Versions: 4.0.0.0