This topic has not yet been rated - Rate this topic

NativeObjectSecurity Class

.NET Framework 4

Provides the ability to control access to native objects without direct manipulation of Access Control Lists (ACLs). Native object types are defined by the ResourceType enumeration.

Inheritance Hierarchy

System.Object
  System.Security.AccessControl.ObjectSecurity
    System.Security.AccessControl.CommonObjectSecurity
      System.Security.AccessControl.NativeObjectSecurity
        More...

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

Syntax

C++

Copy

public abstract class NativeObjectSecurity : CommonObjectSecurity

The NativeObjectSecurity type exposes the following members.

Constructors

	Name	Description
	NativeObjectSecurity(Boolean, ResourceType)	Initializes a new instance of the NativeObjectSecurity class with the specified values.
	NativeObjectSecurity(Boolean, ResourceType, SafeHandle, AccessControlSections)	Initializes a new instance of the NativeObjectSecurity class with the specified values. We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical. For more information, see Remarks.
	NativeObjectSecurity(Boolean, ResourceType, NativeObjectSecurity.ExceptionFromErrorCode, Object)	Initializes a new instance of the NativeObjectSecurity class by using the specified values.
	NativeObjectSecurity(Boolean, ResourceType, String, AccessControlSections)	Initializes a new instance of the NativeObjectSecurity class with the specified values. We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical. For more information, see Remarks.
	NativeObjectSecurity(Boolean, ResourceType, SafeHandle, AccessControlSections, NativeObjectSecurity.ExceptionFromErrorCode, Object)	Initializes a new instance of the NativeObjectSecurity class with the specified values. We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical. For more information, see Remarks.
	NativeObjectSecurity(Boolean, ResourceType, String, AccessControlSections, NativeObjectSecurity.ExceptionFromErrorCode, Object)	Initializes a new instance of the NativeObjectSecurity class with the specified values. We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical. For more information, see Remarks.

Top

Properties

	Name	Description
	AccessRightType	Gets the Type of the securable object associated with this ObjectSecurity object. (Inherited from ObjectSecurity.)
	AccessRulesModified	Gets or sets a Boolean value that specifies whether the access rules associated with this ObjectSecurity object have been modified. (Inherited from ObjectSecurity.)
	AccessRuleType	Gets the Type of the object associated with the access rules of this ObjectSecurity object. The Type object must be an object that can be cast as a SecurityIdentifier object. (Inherited from ObjectSecurity.)
	AreAccessRulesCanonical	Gets a Boolean value that specifies whether the access rules associated with this ObjectSecurity object are in canonical order. (Inherited from ObjectSecurity.)
	AreAccessRulesProtected	Gets a Boolean value that specifies whether the Discretionary Access Control List (DACL) associated with this ObjectSecurity object is protected. (Inherited from ObjectSecurity.)
	AreAuditRulesCanonical	Gets a Boolean value that specifies whether the audit rules associated with this ObjectSecurity object are in canonical order. (Inherited from ObjectSecurity.)
	AreAuditRulesProtected	Gets a Boolean value that specifies whether the System Access Control List (SACL) associated with this ObjectSecurity object is protected. (Inherited from ObjectSecurity.)
	AuditRulesModified	Gets or sets a Boolean value that specifies whether the audit rules associated with this ObjectSecurity object have been modified. (Inherited from ObjectSecurity.)
	AuditRuleType	Gets the Type object associated with the audit rules of this ObjectSecurity object. The Type object must be an object that can be cast as a SecurityIdentifier object. (Inherited from ObjectSecurity.)
	GroupModified	Gets or sets a Boolean value that specifies whether the group associated with the securable object has been modified. (Inherited from ObjectSecurity.)
	IsContainer	Gets a Boolean value that specifies whether this ObjectSecurity object is a container object. (Inherited from ObjectSecurity.)
	IsDS	Gets a Boolean value that specifies whether this ObjectSecurity object is a directory object. (Inherited from ObjectSecurity.)
	OwnerModified	Gets or sets a Boolean value that specifies whether the owner of the securable object has been modified. (Inherited from ObjectSecurity.)

Top

Methods

	Name	Description
	AccessRuleFactory	Initializes a new instance of the AccessRule class with the specified values. (Inherited from ObjectSecurity.)
	AddAccessRule	Adds the specified access rule to the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object. (Inherited from CommonObjectSecurity.)
	AddAuditRule	Adds the specified audit rule to the System Access Control List (SACL) associated with this CommonObjectSecurity object. (Inherited from CommonObjectSecurity.)
	AuditRuleFactory	Initializes a new instance of the AuditRule class with the specified values. (Inherited from ObjectSecurity.)
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetAccessRules	Gets a collection of the access rules associated with the specified security identifier. (Inherited from CommonObjectSecurity.)
	GetAuditRules	Gets a collection of the audit rules associated with the specified security identifier. (Inherited from CommonObjectSecurity.)
	GetGroup	Gets the primary group associated with the specified owner. (Inherited from ObjectSecurity.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetOwner	Gets the owner associated with the specified primary group. (Inherited from ObjectSecurity.)
	GetSecurityDescriptorBinaryForm	Returns an array of byte values that represents the security descriptor information for this ObjectSecurity object. (Inherited from ObjectSecurity.)
	GetSecurityDescriptorSddlForm	Returns the Security Descriptor Definition Language (SDDL) representation of the specified sections of the security descriptor associated with this ObjectSecurity object. (Inherited from ObjectSecurity.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ModifyAccess	Applies the specified modification to the Discretionary Access Control List (DACL) associated with this CommonObjectSecurity object. (Inherited from CommonObjectSecurity.)
	ModifyAccessRule	Applies the specified modification to the Discretionary Access Control List (DACL) associated with this ObjectSecurity object. (Inherited from ObjectSecurity.)
	ModifyAudit	Applies the specified modification to the System Access Control List (SACL) associated with this CommonObjectSecurity object. (Inherited from CommonObjectSecurity.)
	ModifyAuditRule	Applies the specified modification to the System Access Control List (SACL) associated with this ObjectSecurity object. (Inherited from ObjectSecurity.)
	Persist(SafeHandle, 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. (Overrides ObjectSecurity.Persist(SafeHandle, AccessControlSections).)
	Persist(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. (Overrides ObjectSecurity.Persist(String, AccessControlSections).)
	Persist(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.)
	Persist(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.
	Persist(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.
	PurgeAccessRules	Removes all access rules associated with the specified IdentityReference. (Inherited from ObjectSecurity.)
	PurgeAuditRules	Removes all audit rules associated with the specified IdentityReference. (Inherited from ObjectSecurity.)
	ReadLock	Locks this ObjectSecurity object for read access. (Inherited from ObjectSecurity.)
	ReadUnlock	Unlocks this ObjectSecurity object for read access. (Inherited from ObjectSecurity.)
	RemoveAccessRule	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.)
	RemoveAccessRuleAll	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.)
	RemoveAccessRuleSpecific	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.)
	RemoveAuditRule	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.)
	RemoveAuditRuleAll	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.)
	RemoveAuditRuleSpecific	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.)
	ResetAccessRule	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.)
	SetAccessRule	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.)
	SetAccessRuleProtection	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.)
	SetAuditRule	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.)
	SetAuditRuleProtection	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.)
	SetGroup	Sets the primary group for the security descriptor associated with this ObjectSecurity object. (Inherited from ObjectSecurity.)
	SetOwner	Sets the owner for the security descriptor associated with this ObjectSecurity object. (Inherited from ObjectSecurity.)
	SetSecurityDescriptorBinaryForm(Byte[])	Sets the security descriptor for this ObjectSecurity object from the specified array of byte values. (Inherited from ObjectSecurity.)
	SetSecurityDescriptorBinaryForm(Byte[], AccessControlSections)	Sets the specified sections of the security descriptor for this ObjectSecurity object from the specified array of byte values. (Inherited from ObjectSecurity.)
	SetSecurityDescriptorSddlForm(String)	Sets the security descriptor for this ObjectSecurity object from the specified Security Descriptor Definition Language (SDDL) string. (Inherited from ObjectSecurity.)
	SetSecurityDescriptorSddlForm(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.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	WriteLock	Locks this ObjectSecurity object for write access. (Inherited from ObjectSecurity.)
	WriteUnlock	Unlocks this ObjectSecurity object for write access. (Inherited from ObjectSecurity.)

Top

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

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.

Reference

System.Security.AccessControl Namespace

Inheritance Hierarchy

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ