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 */
};
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);
setftime(fd, &t);