Функция 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 завершается успешно, только в том случае, если выполнены нижеследующие условия:

Смотри также

Обзор Управление низкоуровневым доступом, Функции, используемые управлением низкоуровневым доступом, 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.
Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz