Программирование на C и C++

Онлайн справочник программиста на C и C++

setftime

int setftime(int handle, struct ftime *t)

Прототип: 
Описание: 

Эта функция не определена стандартом ANSI С.

Функция setftime() используется для установки даты и времени, ассоциированной с файлом на диске. Она изменяет дату и время файла, ассоциированного с параметром handle, используя информацию, хранящуюся в структуре, на которую указывает параметр t. Структура ftime опре­делена следующим образом:

struct ftime {
unsigned ft_tsec: 5; /* секунды */
unsigned ft_min: 6; /* минуты */
unsigned ft_hour: 5; /* часы */
unsigned ft_day: 5; /* дни */
unsigned ft_month: 4; /* месяцы */
unsigned ft_year: 7; /* годы с 198 0 */
};

Поскольку дата и время файла обычно используются для указания времени последней модифи­кации, то необходимо использовать функцию setftime() достаточно осторожно.

При успешном вызове функции setftime() возвращается значение 0. При возникновении ошиб­ки возвращается —1, а переменная errno принимает одно из следующих значений:

ВеличинаЗначение
EINVFNCНеверный номер функции
EACCESSДоступ запрещен
EBADFНедействительный дескриптор файла
Пример: 
Следующая строка кода устанавливает время и дату файла, задаваемые структурой ftime:
setftime(fd, &t);