NativeObjectSecurity.Persist Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage.
Overloads
| Persist(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 |
| 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 |
| 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 |
| 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 |
Persist(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.
protected:
override void Persist(System::Runtime::InteropServices::SafeHandle ^ handle, System::Security::AccessControl::AccessControlSections includeSections);protected override sealed void Persist (System.Runtime.InteropServices.SafeHandle handle, System.Security.AccessControl.AccessControlSections includeSections);override this.Persist : System.Runtime.InteropServices.SafeHandle * System.Security.AccessControl.AccessControlSections -> unitProtected Overrides NotOverridable Sub Persist (handle As SafeHandle, includeSections As AccessControlSections)Parameters
- handle
- SafeHandle
The handle of the securable object with which this NativeObjectSecurity object is associated.
- includeSections
- 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.
Exceptions
The securable object with which this NativeObjectSecurity object is associated is either a directory or a file, and that directory or file could not be found.
Remarks
When persisting a NativeObjectSecurity 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 NativeObjectSecurity object, sections of the persisted NativeObjectSecurity 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 NativeObjectSecurity object will contain unpredictable values for its audit rules, group, and owner.
Applies to
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.
protected:
override void Persist(System::String ^ name, System::Security::AccessControl::AccessControlSections includeSections);protected override sealed void Persist (string name, System.Security.AccessControl.AccessControlSections includeSections);override this.Persist : string * System.Security.AccessControl.AccessControlSections -> unitProtected Overrides NotOverridable Sub Persist (name As String, includeSections As AccessControlSections)Parameters
- name
- String
The name of the securable object with which this NativeObjectSecurity object is associated.
- includeSections
- 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.
Exceptions
The securable object with which this NativeObjectSecurity object is associated is either a directory or a file, and that directory or file could not be found.
Remarks
When persisting a NativeObjectSecurity 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 NativeObjectSecurity object, sections of the persisted NativeObjectSecurity 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 NativeObjectSecurity object will contain unpredictable values for its audit rules, group, and owner.
Applies to
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.
protected:
void Persist(System::Runtime::InteropServices::SafeHandle ^ handle, System::Security::AccessControl::AccessControlSections includeSections, System::Object ^ exceptionContext);protected void Persist (System.Runtime.InteropServices.SafeHandle handle, System.Security.AccessControl.AccessControlSections includeSections, object? exceptionContext);protected void Persist (System.Runtime.InteropServices.SafeHandle handle, System.Security.AccessControl.AccessControlSections includeSections, object exceptionContext);override this.Persist : System.Runtime.InteropServices.SafeHandle * System.Security.AccessControl.AccessControlSections * obj -> unitProtected Sub Persist (handle As SafeHandle, includeSections As AccessControlSections, exceptionContext As Object)Parameters
- handle
- SafeHandle
The handle of the securable object with which this NativeObjectSecurity object is associated.
- includeSections
- 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.
- exceptionContext
- Object
An object that contains contextual information about the source or destination of the exception.
Exceptions
The securable object with which this NativeObjectSecurity object is associated is either a directory or a file, and that directory or file could not be found.
Remarks
When persisting a NativeObjectSecurity 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 NativeObjectSecurity object, sections of the persisted NativeObjectSecurity 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 NativeObjectSecurity object will contain unpredictable values for its audit rules, group, and owner.
Applies to
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.
protected:
void Persist(System::String ^ name, System::Security::AccessControl::AccessControlSections includeSections, System::Object ^ exceptionContext);protected void Persist (string name, System.Security.AccessControl.AccessControlSections includeSections, object? exceptionContext);protected void Persist (string name, System.Security.AccessControl.AccessControlSections includeSections, object exceptionContext);override this.Persist : string * System.Security.AccessControl.AccessControlSections * obj -> unitProtected Sub Persist (name As String, includeSections As AccessControlSections, exceptionContext As Object)Parameters
- name
- String
The name of the securable object with which this NativeObjectSecurity object is associated.
- includeSections
- 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.
- exceptionContext
- Object
An object that contains contextual information about the source or destination of the exception.
Exceptions
The securable object with which this NativeObjectSecurity object is associated is either a directory or a file, and that directory or file could not be found.
Remarks
When persisting a NativeObjectSecurity 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 NativeObjectSecurity object, sections of the persisted NativeObjectSecurity 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 NativeObjectSecurity object will contain unpredictable values for its audit rules, group, and owner.
