CommonSecurityDescriptor Class

.NET Framework (current version)

Represents a security descriptor. A security descriptor includes an owner, a primary group, a Discretionary Access Control List (DACL), and a System Access Control List (SACL).

Namespace: System.Security.AccessControl
Assembly: mscorlib (in mscorlib.dll)

Inheritance Hierarchy

System::Object
System.Security.AccessControl::GenericSecurityDescriptor
System.Security.AccessControl::CommonSecurityDescriptor

Syntax

C++

public ref class CommonSecurityDescriptor sealed : GenericSecurityDescriptor

Constructors

	Name	Description
	CommonSecurityDescriptor(Boolean, Boolean, array<Byte>^, Int32)	Initializes a new instance of the CommonSecurityDescriptor class from the specified array of byte values.
	CommonSecurityDescriptor(Boolean, Boolean, ControlFlags, SecurityIdentifier^, SecurityIdentifier^, SystemAcl^, DiscretionaryAcl^)	Initializes a new instance of the CommonSecurityDescriptor class from the specified information.
	CommonSecurityDescriptor(Boolean, Boolean, RawSecurityDescriptor^)	Initializes a new instance of the CommonSecurityDescriptor class from the specified RawSecurityDescriptor object.
	CommonSecurityDescriptor(Boolean, Boolean, String^)	Initializes a new instance of the CommonSecurityDescriptor class from the specified Security Descriptor Definition Language (SDDL) string.

Properties

	Name	Description
	BinaryLength	Gets the length, in bytes, of the binary representation of the current GenericSecurityDescriptor object. This length should be used before marshaling the ACL into a binary array with the GetBinaryForm method.(Inherited from GenericSecurityDescriptor.)
	ControlFlags	Gets values that specify behavior of the CommonSecurityDescriptor object.(Overrides GenericSecurityDescriptor::ControlFlags.)
	DiscretionaryAcl	Gets or sets the discretionary access control list (DACL) for this CommonSecurityDescriptor object. The DACL contains access rules.
	Group	Gets or sets the primary group for this CommonSecurityDescriptor object.(Overrides GenericSecurityDescriptor::Group.)
	IsContainer	Gets a Boolean value that specifies whether the object associated with this CommonSecurityDescriptor object is a container object.
	IsDiscretionaryAclCanonical	Gets a Boolean value that specifies whether the Discretionary Access Control List (DACL) associated with this CommonSecurityDescriptor object is in canonical order.
	IsDS	Gets a Boolean value that specifies whether the object associated with this CommonSecurityDescriptor object is a directory object.
	IsSystemAclCanonical	Gets a Boolean value that specifies whether the System Access Control List (SACL) associated with this CommonSecurityDescriptor object is in canonical order.
	Owner	Gets or sets the owner of the object associated with this CommonSecurityDescriptor object.(Overrides GenericSecurityDescriptor::Owner.)
	SystemAcl	Gets or sets the System Access Control List (SACL) for this CommonSecurityDescriptor object. The SACL contains audit rules.

Methods

	Name	Description
	AddDiscretionaryAcl(Byte, Int32)	Sets the DiscretionaryAcl property for this CommonSecurityDescriptor instance and sets the DiscretionaryAclPresent flag.
	AddSystemAcl(Byte, Int32)	Sets the SystemAcl property for this CommonSecurityDescriptor instance and sets the SystemAclPresent flag.
	Equals(Object^)	Determines whether the specified object is equal to the current object.(Inherited from Object.)
	GetBinaryForm(array<Byte>^, Int32)	Returns an array of byte values that represents the information contained in this GenericSecurityDescriptor object.(Inherited from GenericSecurityDescriptor.)
	GetHashCode()	Serves as the default hash function. (Inherited from Object.)
	GetSddlForm(AccessControlSections)	Returns the Security Descriptor Definition Language (SDDL) representation of the specified sections of the security descriptor that this GenericSecurityDescriptor object represents.(Inherited from GenericSecurityDescriptor.)
	GetType()	Gets the Type of the current instance.(Inherited from Object.)
	PurgeAccessControl(SecurityIdentifier^)	Removes all access rules for the specified security identifier from the Discretionary Access Control List (DACL) associated with this CommonSecurityDescriptor object.
	PurgeAudit(SecurityIdentifier^)	Removes all audit rules for the specified security identifier from the System Access Control List (SACL) associated with this CommonSecurityDescriptor object.
	SetDiscretionaryAclProtection(Boolean, Boolean)	Sets the inheritance protection for the Discretionary Access Control List (DACL) associated with this CommonSecurityDescriptor object. DACLs that are protected do not inherit access rules from parent containers.
	SetSystemAclProtection(Boolean, Boolean)	Sets the inheritance protection for the System Access Control List (SACL) associated with this CommonSecurityDescriptor object. SACLs that are protected do not inherit audit rules from parent containers.
	ToString()	Returns a string that represents the current object.(Inherited from Object.)

Version Information

.NET Framework
Available since 2.0

Thread Safety

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