PipeSecurity Class

PipeSecurity Class

 

Represents the access control and audit security for a pipe.

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


[HostProtectionAttribute(SecurityAction.LinkDemand, MayLeakOnAbort = true)]
public class PipeSecurity : NativeObjectSecurity

NameDescription
System_CAPS_pubmethodPipeSecurity()

Initializes a new instance of the PipeSecurity class.

NameDescription
System_CAPS_pubpropertyAccessRightType

Gets the Type of the securable object that is associated with the current PipeSecurity object.(Overrides ObjectSecurity.AccessRightType.)

System_CAPS_protpropertyAccessRulesModified

Gets or sets a Boolean value that specifies whether the access rules associated with this ObjectSecurity object have been modified.(Inherited from ObjectSecurity.)

System_CAPS_pubpropertyAccessRuleType

Gets the Type of the object that is associated with the access rules of the current PipeSecurity object.(Overrides ObjectSecurity.AccessRuleType.)

System_CAPS_pubpropertyAreAccessRulesCanonical

Gets a Boolean value that specifies whether the access rules associated with this ObjectSecurity object are in canonical order.(Inherited from ObjectSecurity.)

System_CAPS_pubpropertyAreAccessRulesProtected

Gets a Boolean value that specifies whether the Discretionary Access Control List (DACL) associated with this ObjectSecurity object is protected.(Inherited from ObjectSecurity.)

System_CAPS_pubpropertyAreAuditRulesCanonical

Gets a Boolean value that specifies whether the audit rules associated with this ObjectSecurity object are in canonical order.(Inherited from ObjectSecurity.)

System_CAPS_pubpropertyAreAuditRulesProtected

Gets a Boolean value that specifies whether the System Access Control List (SACL) associated with this ObjectSecurity object is protected.(Inherited from ObjectSecurity.)

System_CAPS_protpropertyAuditRulesModified

Gets or sets a Boolean value that specifies whether the audit rules associated with this ObjectSecurity object have been modified.(Inherited from ObjectSecurity.)

System_CAPS_pubpropertyAuditRuleType

Gets the Type object associated with the audit rules of the current PipeSecurity object.(Overrides ObjectSecurity.AuditRuleType.)

System_CAPS_protpropertyGroupModified

Gets or sets a Boolean value that specifies whether the group associated with the securable object has been modified. (Inherited from ObjectSecurity.)

System_CAPS_protpropertyIsContainer

Gets a Boolean value that specifies whether this ObjectSecurity object is a container object.(Inherited from ObjectSecurity.)

System_CAPS_protpropertyIsDS

Gets a Boolean value that specifies whether this ObjectSecurity object is a directory object.(Inherited from ObjectSecurity.)

System_CAPS_protpropertyOwnerModified

Gets or sets a Boolean value that specifies whether the owner of the securable object has been modified.(Inherited from ObjectSecurity.)

NameDescription
System_CAPS_pubmethodAccessRuleFactory(IdentityReference, Int32, Boolean, InheritanceFlags, PropagationFlags, AccessControlType)
System_CAPS_protmethodAddAccessRule(AccessRule)

Adds the specified access rule to the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodAddAccessRule(PipeAccessRule)

Adds an access rule to the Discretionary Access Control List (DACL) that is associated with the current PipeSecurity object.

System_CAPS_protmethodAddAuditRule(AuditRule)

Adds the specified audit rule to the System Access Control List (SACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodAddAuditRule(PipeAuditRule)

Adds an audit rule to the System Access Control List (SACL)that is associated with the current PipeSecurity object.

System_CAPS_pubmethodAuditRuleFactory(IdentityReference, Int32, Boolean, InheritanceFlags, PropagationFlags, AuditFlags)
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetAccessRules(Boolean, Boolean, Type)

Gets a collection of the access rules associated with the specified security identifier.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodGetAuditRules(Boolean, Boolean, Type)

Gets a collection of the audit rules associated with the specified security identifier.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodGetGroup(Type)

Gets the primary group associated with the specified owner.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetOwner(Type)

Gets the owner associated with the specified primary group.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodGetSecurityDescriptorBinaryForm()

Returns an array of byte values that represents the security descriptor information for this ObjectSecurity object.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodGetSecurityDescriptorSddlForm(AccessControlSections)

Returns the Security Descriptor Definition Language (SDDL) representation of the specified sections of the security descriptor associated with this ObjectSecurity object.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_protmethodModifyAccess(AccessControlModification, AccessRule, Boolean)

Applies the specified modification to the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodModifyAccessRule(AccessControlModification, AccessRule, Boolean)

Applies the specified modification to the Discretionary Access Control List (DACL) associated with this ObjectSecurity object.(Inherited from ObjectSecurity.)

System_CAPS_protmethodModifyAudit(AccessControlModification, AuditRule, Boolean)

Applies the specified modification to the System Access Control List (SACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodModifyAuditRule(AccessControlModification, AuditRule, Boolean)

Applies the specified modification to the System Access Control List (SACL) associated with this ObjectSecurity object.(Inherited from ObjectSecurity.)

System_CAPS_protmethodPersist(Boolean, String, AccessControlSections)

Saves the specified sections of the security descriptor associated with this ObjectSecurity object to permanent storage. We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical. For more information, see Remarks.(Inherited from ObjectSecurity.)

System_CAPS_protmethodPersist(SafeHandle)

Saves the specified sections of the security descriptor that is associated with the current PipeSecurity object to permanent storage.

System_CAPS_protmethodPersist(SafeHandle, AccessControlSections)

Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. We recommend.persist that the values of the includeSections parameters passed to the constructor and persist methods be identical. For more information, see Remarks.(Inherited from NativeObjectSecurity.)

System_CAPS_protmethodPersist(SafeHandle, AccessControlSections, Object)

Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical. For more information, see Remarks.(Inherited from NativeObjectSecurity.)

System_CAPS_protmethodPersist(String)

Saves the specified sections of the security descriptor that is associated with the current PipeSecurity object to permanent storage.

System_CAPS_protmethodPersist(String, AccessControlSections)

Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical. For more information, see Remarks.(Inherited from NativeObjectSecurity.)

System_CAPS_protmethodPersist(String, AccessControlSections, Object)

Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical. For more information, see Remarks.(Inherited from NativeObjectSecurity.)

System_CAPS_pubmethodPurgeAccessRules(IdentityReference)

Removes all access rules associated with the specified IdentityReference.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodPurgeAuditRules(IdentityReference)

Removes all audit rules associated with the specified IdentityReference.(Inherited from ObjectSecurity.)

System_CAPS_protmethodReadLock()

Locks this ObjectSecurity object for read access.(Inherited from ObjectSecurity.)

System_CAPS_protmethodReadUnlock()

Unlocks this ObjectSecurity object for read access.(Inherited from ObjectSecurity.)

System_CAPS_protmethodRemoveAccessRule(AccessRule)

Removes access rules that contain the same security identifier and access mask as the specified access rule from the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodRemoveAccessRule(PipeAccessRule)

Removes an access rule from the Discretionary Access Control List (DACL) that is associated with the current PipeSecurity object.

System_CAPS_protmethodRemoveAccessRuleAll(AccessRule)

Removes all access rules that have the same security identifier as the specified access rule from the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_protmethodRemoveAccessRuleSpecific(AccessRule)

Removes all access rules that exactly match the specified access rule from the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodRemoveAccessRuleSpecific(PipeAccessRule)

Removes the specified access rule from the Discretionary Access Control List (DACL) that is associated with the current PipeSecurity object.

System_CAPS_protmethodRemoveAuditRule(AuditRule)

Removes audit rules that contain the same security identifier and access mask as the specified audit rule from the System Access Control List (SACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodRemoveAuditRule(PipeAuditRule)

Removes an audit rule from the System Access Control List (SACL) that is associated with the current PipeSecurity object.

System_CAPS_protmethodRemoveAuditRuleAll(AuditRule)

Removes all audit rules that have the same security identifier as the specified audit rule from the System Access Control List (SACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodRemoveAuditRuleAll(PipeAuditRule)

Removes all audit rules that have the same security identifier as the specified audit rule from the System Access Control List (SACL) that is associated with the current PipeSecurity object.

System_CAPS_protmethodRemoveAuditRuleSpecific(AuditRule)

Removes all audit rules that exactly match the specified audit rule from the System Access Control List (SACL) associated with this CommonObjectSecurity object.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodRemoveAuditRuleSpecific(PipeAuditRule)

Removes the specified audit rule from the System Access Control List (SACL) that is associated with the current PipeSecurity object.

System_CAPS_protmethodResetAccessRule(AccessRule)

Removes all access rules in the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object and then adds the specified access rule.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodResetAccessRule(PipeAccessRule)

Removes all access rules in the Discretionary Access Control List (DACL) that is associated with the current PipeSecurity object and then adds the specified access rule.

System_CAPS_protmethodSetAccessRule(AccessRule)

Removes all access rules that contain the same security identifier and qualifier as the specified access rule in the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object and then adds the specified access rule.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodSetAccessRule(PipeAccessRule)

Sets an access rule in the Discretionary Access Control List (DACL) that is associated with the current PipeSecurity object.

System_CAPS_pubmethodSetAccessRuleProtection(Boolean, Boolean)

Sets or removes protection of the access rules associated with this ObjectSecurity object. Protected access rules cannot be modified by parent objects through inheritance.(Inherited from ObjectSecurity.)

System_CAPS_protmethodSetAuditRule(AuditRule)

Removes all audit rules that contain the same security identifier and qualifier as the specified audit rule in the System Access Control List (SACL) associated with this CommonObjectSecurity object and then adds the specified audit rule.(Inherited from CommonObjectSecurity.)

System_CAPS_pubmethodSetAuditRule(PipeAuditRule)

Sets an audit rule in the System Access Control List (SACL) that is associated with the current PipeSecurity object.

System_CAPS_pubmethodSetAuditRuleProtection(Boolean, Boolean)

Sets or removes protection of the audit rules associated with this ObjectSecurity object. Protected audit rules cannot be modified by parent objects through inheritance.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodSetGroup(IdentityReference)

Sets the primary group for the security descriptor associated with this ObjectSecurity object.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodSetOwner(IdentityReference)

Sets the owner for the security descriptor associated with this ObjectSecurity object.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodSetSecurityDescriptorBinaryForm(Byte[])

Sets the security descriptor for this ObjectSecurity object from the specified array of byte values.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodSetSecurityDescriptorBinaryForm(Byte[], AccessControlSections)

Sets the specified sections of the security descriptor for this ObjectSecurity object from the specified array of byte values.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodSetSecurityDescriptorSddlForm(String)

Sets the security descriptor for this ObjectSecurity object from the specified Security Descriptor Definition Language (SDDL) string.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodSetSecurityDescriptorSddlForm(String, AccessControlSections)

Sets the specified sections of the security descriptor for this ObjectSecurity object from the specified Security Descriptor Definition Language (SDDL) string.(Inherited from ObjectSecurity.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

System_CAPS_protmethodWriteLock()

Locks this ObjectSecurity object for write access.(Inherited from ObjectSecurity.)

System_CAPS_protmethodWriteUnlock()

Unlocks this ObjectSecurity object for write access.(Inherited from ObjectSecurity.)

The 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 PipeAccessRule object, while each audit rule is represented by a PipeAuditRule object.

The 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 PipeAccessRule and PipeAuditRule classes are abstractions of the access control entries (ACEs) that comprise DACLs and SACLs.

The 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 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 SetAccessControl method. To retrieve access or audit rules from an existing file, use the GetAccessControl method.

.NET Framework
Available since 3.5

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft