SetFileAttributes

WinApi Функция SetFileAttributes

Описание:
function SetFileAttributes(lpFileName: PChar; dwFileAttributes: DWORD): BOOL;

Функция устанавливает атрибуты файла или папки.

Параметры
lpFileName: Строка которая определяет путь к файлу или папки, чьи аттрибуты необходимо установить.
Win NT\2000\XP: В ANSI-версии этой функции строка ограничена MAX_PATH. Для того чтобы вызвать расширенную функцию вызовите функцию SetFileAttributesW и добавте "\?\" в начало строки содержащей путь.

Win 95/98/Me: Cтрока не должна превышать константу MAX_PATH.

dwFileAttributes: Аттрибуты для файла или папки. См. FILE_ATTRIBUTE_. Тем не менее все другие значения аннулируют аттрибут FILE_ATTRIBUTE_NORMAL.

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

Замечания
Далее описывается как установить аттрибуты, которые нельзя установить функцией SetFileAttributes.

FILE_ATTRIBUTE_COMPRESSED, Чтобы устанавливать файловое состояние сжатия, использовать функцию DeviceIoControl с операцией FSCTL_SET_COMPRESSION.
FILE_ATTRIBUTE_DEVICE - Зарезервирован; не использовать.
FILE_ATTRIBUTE_DIRECTORY - Файлу не может быть присвоен аттрибут папки. Для того, чтобы создать папку, используйте функции CreateDirectory или CreateDirectoryEx.
FILE_ATTRIBUTE_ENCRYPTED - Чтобы создать закодированный файл, используйте функцию CreateFile с атрибутом FILE_ATTRIBUTE_ENCRYPTED. Для того, чтобы преобразовывать существующий файл в закодированный файл, используйте функцию EncryptFile.

FILE_ATTRIBUTE_REPARSE_POINT - Чтобы соединить реперную точку с файлом, используйте функцию DeviceIoControl с операцией FSCTL_SET_REPARSE_POINT.
FILE_ATTRIBUTE_SPARSE_FILE - Чтобы установить аттрибут редкий файл, используйте функцию DeviceIoControl с операцией FSCTL_SET_SPARSE.

Материал взят из:
Русская спpавка по Windows API



Последние из рубрики

ОтменитьДобавить комментарий