Directory.GetAccessControl Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает список управления доступом Windows (ACL) для каталога.
Перегрузки
| GetAccessControl(String) |
Возвращает объект DirectorySecurity, инкапсулирующий записи списка управления доступом (ACL) для указанного каталога. |
| GetAccessControl(String, AccessControlSections) |
Возвращает объект DirectorySecurity, который инкапсулирует указанный тип записей списка управления доступом (ACL) для указанного каталога. |
GetAccessControl(String)
Возвращает объект DirectorySecurity, инкапсулирующий записи списка управления доступом (ACL) для указанного каталога.
public:
static System::Security::AccessControl::DirectorySecurity ^ GetAccessControl(System::String ^ path);public static System.Security.AccessControl.DirectorySecurity GetAccessControl (string path);static member GetAccessControl : string -> System.Security.AccessControl.DirectorySecurityPublic Shared Function GetAccessControl (path As String) As DirectorySecurityПараметры
- path
- String
Путь к каталогу, содержашем объект DirectorySecurity, описывающий сведения о списке управления доступом файла (ACL).
Возвращаемое значение
Объект, инкапсулирующий правила управления доступом для файла, описанного параметром path.
Исключения
Параметр pathnull.
При открытии каталога произошла ошибка ввода-вывода.
Произошла ошибка на уровне системы, например каталог не найден. Конкретное исключение может быть подклассом SystemException.
Параметр path указал каталог, доступный только для чтения.
-или-
Эта операция не поддерживается на текущей платформе.
-или-
Вызывающий объект не имеет требуемого разрешения.
Комментарии
Используйте метод GetAccessControl для получения записей списка управления доступом (ACL) для каталога.
ACL описывает отдельных лиц и групп, имеющих или не имеющих прав на определенные действия в указанном файле или каталоге. Дополнительные сведения см. в разделе Практическое руководство. Добавление или удаление записей списка управления доступом.
В средах NTFS ReadAttributes и ReadExtendedAttributes предоставляются пользователю, если у пользователя есть ListDirectory права на родительскую папку. Чтобы запретить ReadAttributes и ReadExtendedAttributes, запретить ListDirectory в родительском каталоге.
Применяется к
GetAccessControl(String, AccessControlSections)
Возвращает объект DirectorySecurity, который инкапсулирует указанный тип записей списка управления доступом (ACL) для указанного каталога.
public:
static System::Security::AccessControl::DirectorySecurity ^ GetAccessControl(System::String ^ path, System::Security::AccessControl::AccessControlSections includeSections);public static System.Security.AccessControl.DirectorySecurity GetAccessControl (string path, System.Security.AccessControl.AccessControlSections includeSections);static member GetAccessControl : string * System.Security.AccessControl.AccessControlSections -> System.Security.AccessControl.DirectorySecurityPublic Shared Function GetAccessControl (path As String, includeSections As AccessControlSections) As DirectorySecurityПараметры
- path
- String
Путь к каталогу, содержашем объект DirectorySecurity, описывающий сведения о списке управления доступом файла (ACL).
- includeSections
- AccessControlSections
Одно из значений AccessControlSections, указывающее тип данных списка управления доступом (ACL).
Возвращаемое значение
Объект, инкапсулирующий правила управления доступом для файла, описанного параметром path.
Исключения
Параметр pathnull.
При открытии каталога произошла ошибка ввода-вывода.
Произошла ошибка на уровне системы, например каталог не найден. Конкретное исключение может быть подклассом SystemException.
Параметр path указал каталог, доступный только для чтения.
-или-
Эта операция не поддерживается на текущей платформе.
-или-
Вызывающий объект не имеет требуемого разрешения.
Комментарии
Используйте метод GetAccessControl для получения записей списка управления доступом (ACL) для каталога.
ACL описывает отдельных лиц и групп, имеющих или не имеющих прав на определенные действия в указанном файле или каталоге. Дополнительные сведения см. в разделе Практическое руководство. Добавление или удаление записей списка управления доступом.
В средах NTFS ReadAttributes и ReadExtendedAttributes предоставляются пользователю, если у пользователя есть ListDirectory права на родительскую папку. Чтобы запретить ReadAttributes и ReadExtendedAttributes, запретить ListDirectory в родительском каталоге.
