DirectorySecurity Constructors
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.
Initializes a new instance of the DirectorySecurity class.
Overloads
| DirectorySecurity() |
Initializes a new instance of the DirectorySecurity class. |
| DirectorySecurity(String, AccessControlSections) |
Initializes a new instance of the DirectorySecurity class from a specified directory using the specified values of the AccessControlSections enumeration. |
DirectorySecurity()
Initializes a new instance of the DirectorySecurity class.
public:
DirectorySecurity();public DirectorySecurity ();Public Sub New ()Exceptions
The current operating system is not Microsoft Windows 2000 or later.
Remarks
Use this constructor when you want to create an empty DirectorySecurity object that is not based on an existing directory. You can then populate the object with access control information and apply it to a directory.
Applies to
DirectorySecurity(String, AccessControlSections)
Initializes a new instance of the DirectorySecurity class from a specified directory using the specified values of the AccessControlSections enumeration.
public:
DirectorySecurity(System::String ^ name, System::Security::AccessControl::AccessControlSections includeSections);public DirectorySecurity (string name, System.Security.AccessControl.AccessControlSections includeSections);new System.Security.AccessControl.DirectorySecurity : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.DirectorySecurityPublic Sub New (name As String, includeSections As AccessControlSections)Parameters
- name
- String
The location of a directory to create a DirectorySecurity object from.
- includeSections
- AccessControlSections
One of the AccessControlSections values that specifies the type of access control list (ACL) information to retrieve.
Exceptions
The name parameter is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
The name parameter is null.
The specified path is invalid, (for example, it is on an unmapped drive).
The file specified in the name parameter was not found.
An I/O error occurred while opening the directory.
The name parameter is in an invalid format.
The current operating system is not Microsoft Windows 2000 or later.
The specified path, file name, or both exceed the system-defined maximum length.
The current system account does not have administrative privileges.
The directory could not be found.
The name parameter specified a directory that is read-only.
-or-
This operation is not supported on the current platform.
-or-
The caller does not have the required permission.
Remarks
This constructor retrieves the access control information for the specified directory and then creates a DirectorySecurity object that encapsulates that information. You can then inspect, add, or delete the access control information for the specified directory.
