NativeObjectSecurity.Persist Method

Definition

Speichert die angegebenen Abschnitte der diesem NativeObjectSecurity-Objekt zugeordneten Sicherheitsbeschreibung im dauerhaften Speicher.Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage.

Overloads

Persist(SafeHandle, AccessControlSections)

Speichert die angegebenen Abschnitte der diesem NativeObjectSecurity-Objekt zugeordneten Sicherheitsbeschreibung im dauerhaften Speicher.Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. Die Werte der includeSections-Parameter, die an die Konstruktor- und die Persist-Methoden übergeben werden, sollten identisch sein.We recommend.persist that the values of the includeSections parameters passed to the constructor and persist methods be identical.

Persist(String, AccessControlSections)

Speichert die angegebenen Abschnitte der diesem NativeObjectSecurity-Objekt zugeordneten Sicherheitsbeschreibung im dauerhaften Speicher.Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. Die Werte der includeSections-Parameter, die an die Konstruktor- und die Persist-Methoden übergeben werden, sollten identisch sein.We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical.

Persist(SafeHandle, AccessControlSections, Object)

Speichert die angegebenen Abschnitte der diesem NativeObjectSecurity-Objekt zugeordneten Sicherheitsbeschreibung im dauerhaften Speicher.Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. Die Werte der includeSections-Parameter, die an die Konstruktor- und die Persist-Methoden übergeben werden, sollten identisch sein.We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical.

Persist(String, AccessControlSections, Object)

Speichert die angegebenen Abschnitte der diesem NativeObjectSecurity-Objekt zugeordneten Sicherheitsbeschreibung im dauerhaften Speicher.Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. Die Werte der includeSections-Parameter, die an die Konstruktor- und die Persist-Methoden übergeben werden, sollten identisch sein.We recommend that the values of the includeSections parameters passed to the constructor and persist methods be identical.

Persist(SafeHandle, AccessControlSections)

Speichert die angegebenen Abschnitte der diesem NativeObjectSecurity-Objekt zugeordneten Sicherheitsbeschreibung im dauerhaften Speicher.Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. Die Werte der includeSections-Parameter, die an die Konstruktor- und die Persist-Methoden übergeben werden, sollten identisch sein.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 -> unit
Protected Overrides NotOverridable Sub Persist (handle As SafeHandle, includeSections As AccessControlSections)

Parameters

handle
SafeHandle

Das Handle des sicherungsfähigen Objekts, dem dieses NativeObjectSecurity-Objekt zugeordnet ist.The handle of the securable object with which this NativeObjectSecurity object is associated.

includeSections
AccessControlSections

Einer der AccessControlSections-Enumerationswerte, der die Abschnitte der Sicherheitsbeschreibung (Zugriffsregeln, Überwachungsregeln, Besitzer, primäre Gruppe) des zu speichernden sicherungsfähigen Objekts angibt.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

Bei dem sicherungsfähigen Objekt, das diesem NativeObjectSecurity-Objekt zugeordnet ist, handelt es sich um ein Verzeichnis oder eine Datei, und dieses Verzeichnis oder diese Datei konnte nicht gefunden werden.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

Wenn beim Beibehalten eines NativeObjectSecurity Objekts der Wert des includeSections-Parameters, der an die Persist-Methode übergeben wurde, nicht mit dem Wert des includeSections-Parameters identisch ist, der an den Konstruktor übergeben wurde, der zum Erstellen dieses NativeObjectSecurity Objekts verwendet wurde, können Abschnitte des beibehaltenen NativeObjectSecurity Objekts unvorhersehbare Werte enthalten.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. Wenn z. b. ein Konstruktor mit einem includeSections-Wert Accessaufgerufen wird und später eine Persist-Methode für dieses Objekt mit dem includeSections Wert Allaufgerufen wird, enthält das resultierende persistente NativeObjectSecurity Objekt unvorhersehbare Werte für die Überwachungsregeln, die Gruppe und den Besitzer.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.

Persist(String, AccessControlSections)

Speichert die angegebenen Abschnitte der diesem NativeObjectSecurity-Objekt zugeordneten Sicherheitsbeschreibung im dauerhaften Speicher.Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. Die Werte der includeSections-Parameter, die an die Konstruktor- und die Persist-Methoden übergeben werden, sollten identisch sein.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 -> unit
Protected Overrides NotOverridable Sub Persist (name As String, includeSections As AccessControlSections)

Parameters

name
String

Der Name des sicherungsfähigen Objekts, dem dieses NativeObjectSecurity-Objekt zugeordnet ist.The name of the securable object with which this NativeObjectSecurity object is associated.

includeSections
AccessControlSections

Einer der AccessControlSections-Enumerationswerte, der die Abschnitte der Sicherheitsbeschreibung (Zugriffsregeln, Überwachungsregeln, Besitzer, primäre Gruppe) des zu speichernden sicherungsfähigen Objekts angibt.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

Bei dem sicherungsfähigen Objekt, das diesem NativeObjectSecurity-Objekt zugeordnet ist, handelt es sich um ein Verzeichnis oder eine Datei, und dieses Verzeichnis oder diese Datei konnte nicht gefunden werden.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

Wenn beim Beibehalten eines NativeObjectSecurity Objekts der Wert des includeSections-Parameters, der an die Persist-Methode übergeben wurde, nicht mit dem Wert des includeSections-Parameters identisch ist, der an den Konstruktor übergeben wurde, der zum Erstellen dieses NativeObjectSecurity Objekts verwendet wurde, können Abschnitte des beibehaltenen NativeObjectSecurity Objekts unvorhersehbare Werte enthalten.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. Wenn z. b. ein Konstruktor mit einem includeSections-Wert Accessaufgerufen wird und später eine Persist-Methode für dieses Objekt mit dem includeSections Wert Allaufgerufen wird, enthält das resultierende persistente NativeObjectSecurity Objekt unvorhersehbare Werte für die Überwachungsregeln, die Gruppe und den Besitzer.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.

Persist(SafeHandle, AccessControlSections, Object)

Speichert die angegebenen Abschnitte der diesem NativeObjectSecurity-Objekt zugeordneten Sicherheitsbeschreibung im dauerhaften Speicher.Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. Die Werte der includeSections-Parameter, die an die Konstruktor- und die Persist-Methoden übergeben werden, sollten identisch sein.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);
override this.Persist : System.Runtime.InteropServices.SafeHandle * System.Security.AccessControl.AccessControlSections * obj -> unit
Protected Sub Persist (handle As SafeHandle, includeSections As AccessControlSections, exceptionContext As Object)

Parameters

handle
SafeHandle

Das Handle des sicherungsfähigen Objekts, dem dieses NativeObjectSecurity-Objekt zugeordnet ist.The handle of the securable object with which this NativeObjectSecurity object is associated.

includeSections
AccessControlSections

Einer der AccessControlSections-Enumerationswerte, der die Abschnitte der Sicherheitsbeschreibung (Zugriffsregeln, Überwachungsregeln, Besitzer, primäre Gruppe) des zu speichernden sicherungsfähigen Objekts angibt.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

Ein Objekt, das Kontextinformationen zur Quelle oder zum Ziel der Ausnahme enthält.An object that contains contextual information about the source or destination of the exception.

Exceptions

Bei dem sicherungsfähigen Objekt, das diesem NativeObjectSecurity-Objekt zugeordnet ist, handelt es sich um ein Verzeichnis oder eine Datei, und dieses Verzeichnis oder diese Datei konnte nicht gefunden werden.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

Wenn beim Beibehalten eines NativeObjectSecurity Objekts der Wert des includeSections-Parameters, der an die Persist-Methode übergeben wurde, nicht mit dem Wert des includeSections-Parameters identisch ist, der an den Konstruktor übergeben wurde, der zum Erstellen dieses NativeObjectSecurity Objekts verwendet wurde, können Abschnitte des beibehaltenen NativeObjectSecurity Objekts unvorhersehbare Werte enthalten.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. Wenn z. b. ein Konstruktor mit einem includeSections-Wert Accessaufgerufen wird und später eine Persist-Methode für dieses Objekt mit dem includeSections Wert Allaufgerufen wird, enthält das resultierende persistente NativeObjectSecurity Objekt unvorhersehbare Werte für die Überwachungsregeln, die Gruppe und den Besitzer.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.

Persist(String, AccessControlSections, Object)

Speichert die angegebenen Abschnitte der diesem NativeObjectSecurity-Objekt zugeordneten Sicherheitsbeschreibung im dauerhaften Speicher.Saves the specified sections of the security descriptor associated with this NativeObjectSecurity object to permanent storage. Die Werte der includeSections-Parameter, die an die Konstruktor- und die Persist-Methoden übergeben werden, sollten identisch sein.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);
override this.Persist : string * System.Security.AccessControl.AccessControlSections * obj -> unit
Protected Sub Persist (name As String, includeSections As AccessControlSections, exceptionContext As Object)

Parameters

name
String

Der Name des sicherungsfähigen Objekts, dem dieses NativeObjectSecurity-Objekt zugeordnet ist.The name of the securable object with which this NativeObjectSecurity object is associated.

includeSections
AccessControlSections

Einer der AccessControlSections-Enumerationswerte, der die Abschnitte der Sicherheitsbeschreibung (Zugriffsregeln, Überwachungsregeln, Besitzer, primäre Gruppe) des zu speichernden sicherungsfähigen Objekts angibt.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

Ein Objekt, das Kontextinformationen zur Quelle oder zum Ziel der Ausnahme enthält.An object that contains contextual information about the source or destination of the exception.

Exceptions

Bei dem sicherungsfähigen Objekt, das diesem NativeObjectSecurity-Objekt zugeordnet ist, handelt es sich um ein Verzeichnis oder eine Datei, und dieses Verzeichnis oder diese Datei konnte nicht gefunden werden.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

Wenn beim Beibehalten eines NativeObjectSecurity Objekts der Wert des includeSections-Parameters, der an die Persist-Methode übergeben wurde, nicht mit dem Wert des includeSections-Parameters identisch ist, der an den Konstruktor übergeben wurde, der zum Erstellen dieses NativeObjectSecurity Objekts verwendet wurde, können Abschnitte des beibehaltenen NativeObjectSecurity Objekts unvorhersehbare Werte enthalten.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. Wenn z. b. ein Konstruktor mit einem includeSections-Wert Accessaufgerufen wird und später eine Persist-Methode für dieses Objekt mit dem includeSections Wert Allaufgerufen wird, enthält das resultierende persistente NativeObjectSecurity Objekt unvorhersehbare Werte für die Überwachungsregeln, die Gruppe und den Besitzer.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