RawAcl.InsertAce(Int32, GenericAce) 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.
Inserts the specified Access Control Entry (ACE) at the specified index.
public:
void InsertAce(int index, System::Security::AccessControl::GenericAce ^ ace);
public void InsertAce (int index, System.Security.AccessControl.GenericAce ace);
member this.InsertAce : int * System.Security.AccessControl.GenericAce -> unit
Public Sub InsertAce (index As Integer, ace As GenericAce)
Parameters
- index
- Int32
The position at which to add the new ACE. Specify the value of the Count property to insert an ACE at the end of the RawAcl object.
- ace
- GenericAce
The ACE to insert.
Exceptions
offset
is negative or too high to allow the entire GenericAcl to be copied into array
.
Remarks
The inserted ACE is not cloned before insertion, so any modifications to the ACE after it has been inserted are reflected in the Access Control List (ACL).