Persist Method (SafeHandle, AccessControlSections)
Collapse the table of content
Expand the table of content

ObjectSecurity.Persist Method (SafeHandle, 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.

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

protected virtual void Persist(
	SafeHandle handle,
	AccessControlSections includeSections


Type: System.Runtime.InteropServices.SafeHandle

The handle used to retrieve the persisted information.

Type: System.Security.AccessControl.AccessControlSections

One of the AccessControlSections enumeration values that specifies the sections of the security descriptor (access rules, audit rules, owner, primary group) of the securable object to save.

When persisting a ObjectSecurity object, if the value of the includeSections parameter passed to the Persist method is not identical to the value of the includeSections parameter passed to the constructor used to create that ObjectSecurity object, sections of the persisted ObjectSecurity object can contain unpredictable values. For example, if a constructor is called with an includeSections value of Access, and later a Persist method is called on that object with an includeSections value of All, the resulting persisted ObjectSecurity object will contain unpredictable values for its audit rules, group, and owner.

Universal Windows Platform
Available since 10
.NET Framework
Available since 2.0
Return to top
© 2016 Microsoft