Функция SetFileSecurity

Функция SetFileSecurity устанавливает защиту (систему безопасности) объекта файла или каталога. Функция устаревшая. Вместо неё используйте функцию SetNamedSecurityInfo.

Windows NT 3.51 и ранее: функция SetNamedSecurityInfo не поддерживается.

Синтаксис

BOOL SetFileSecurity(
  LPCTSTR lpFileName, 
  SECURITY_INFORMATION SecurityInformation, 
  PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Параметры

lpFileName

[in] Указатель на символьную строку с нулем в конце, определяющую файл или каталог для которого устанавливается защита.

Обратите внимание! на то, что эта защита, примененная к каталогу не наследуется его дочерними элементами.

SecurityInformation

[in] Определяет структуру SECURITY_INFORMATION, которая идентифицирует содержание дескриптора безопасности (security descriptor), на который указывает параметр pSecurityDescriptor.

pSecurityDescriptor

[in] Указатель на структуру SECURITY_DESCRIPTOR.

Возвращаемые значения

Если функция завершается успешно, возвращаемое значение - не нуль.

Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.

Замечания

Функция SetFileSecurity завершается успешно, только в том случае, если выполнены нижеследующие условия:

Если устанавливается владелец объекта , то вызывающий процесс ( process) должен иметь, или разрешение WRITE_OWNER, или быть владельцем объекта.
Если устанавливается список разграничительного контроля доступа (DACL) объекта, то вызывающий процесс должен иметь, или разрешение WRITE_DAC, или быть владельцем объекта.
Если устанавливается системный список контроля доступа (SACL) объекта, то для вызывающего процесса должна быть разрешена привилегия SE_SECURITY_NAME.

Смотри также

Обзор Управление низкоуровневым доступом, Функции, используемые управлением низкоуровневым доступом, GetFileSecurity, SECURITY_DESCRIPTOR, SECURITY_INFORMATION, SetKernelObjectSecurity, SetNamedSecurityInfo, SetPrivateObjectSecurity, SetUserObjectSecurity

Размещение и совместимость SetFileSecurity
К	Windows XP	Да
л	Windows 2000 Professional	Да
и	Windows NT Workstation	Да версии 3.1 и выше
е	Windows Me	Нет
н	Windows 98	Нет
т	Windows 95	Нет

С	Windows Server 2003	Да
е	Windows 2000 Server	Да
р	Windows NT Server	Да версии 3.1 и выше
в
е
р
Используемая библиотека		Advapil32.lib
Используемая DLL		advapi32.dll
Заголовочный файл
- объявлено в		Winbase.h
- включено в		Windows.h
Unicode		Реализуется как версии Unicode и ANSI.
Замечания по платформе		Не имеется

Назад в оглавление

На главную страницу

На оглавление справки