Русский справочник по Win32 API
Шрифт:
EmptyClipboard, GetClipboardViewer .
Время
CompareFileTime
Функция CompareFileTime сравнивает два 64-битных файловых времени.
LONG CompareFileTime (
CONST FILETIME * lpFileTime1 , // pointer to first file time
CONST FILETIME * lpFileTime2 // pointer to second file time
);
lpFileTime 1– указывает на структуру типа FILETIME , которая определяет первое 64-битное файловое время.
lpFileTime 2– указывает на структуру типа FILETIME , которая определяет второе 64-битное файловое время.
Возвращаемые значения
В случае успеха возвращается одно из следующих значений:
| Значение | Пояснение |
| – 1 | Первое время меньше второго. |
| 0 | Времена равны. |
| +1 | Первое время больше второго. |
См. также
GetFileTime, FILETIME .
GetFileTime
Функция GetFileTime извлекает дату и время файла, когда он был создан, когда к нему последний раз обращались, и когда он последний раз был изменен.
BOOL GetFileTime (
HANDLE hFile , // идентифицирует файл
LPFILETIME lpCreationTime , // адрес времени создания файла
LPFILETIME lpLastAccessTime , // адрес времени последнего доступа
// к файлу
LPFILETIME lpLastWriteTime // адрес времени последней записи в файл
);
Параметры
hFile– идентифицирует файл, для которого извлекаются дата и время. Файловый дескриптор должен быть создан с доступом GENERIC_READ к файлу.
lpCreationTime– указывает на структуру типа FILETIME , которая получает дату и время создания файла. Значение этого параметра может быть равно NULL, если приложению не требуется эта информация.
lpLastAccessTime– указывает на структуру типа FILETIME , которая получает дату и время последнего доступа к файлу. Время последнего доступа включает в себя время, когда в последний раз: в файл записывалась информация, читалась информация из файла, или, в случае исполняемых файлов, файл запускался на исполнение. Значение этого параметра может быть равно NULL, если приложению не требуется
эта информация.lpLastWriteTime– указывает на структуру типа FILETIME , которая получает дату и время последней записи в файл. Значение этого параметра может быть равно NULL, если приложению не требуется эта информация.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
Комментарии
Файловые системы FAT и NTFS поддерживают время создания файла, время последнего доступа к файлу и время последней записи в файл.
Windows 95: Точность значения времени для файла в файловой системе FAT - 2 секунды. Точность значения времени для файлов в других файловых системах, например, на сетевых дисках, зависит от файловой системы, но также может быть ограничена удаленным устройством.
См. также
FILETIME, GetFileSize, GetFileType, SetFileTime .
Прямоугольники
CopyRect
Функция CopyRect копирует координаты одного прямоугольника в другой.
BOOL CopyRect (
LPRECT lprcDst , // указатель на структуру для прямоугольника
// назначения
CONST RECT * lprcSrc // указатель на структуру для исходного
// прямоугольника
);
Параметры
lprcDst– указывает на структуру RECT , которая получает логические координаты исходного прямоугольника.
lprcSrc– указывает на структуру RECT , чьи координаты копируются.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .
См. также
RECT, SetRect, SetRectEmpty .
Диалоговые окна
CreateDialog
Макрос CreateDialog создает немодальное диалоговое окно из ресурса - шаблона диалогового окна. Макрос CreateDialog использует функцию CreateDialogParam .
HWND CreateDialog (
HINSTANCE hInstance , // дескриптор экземпляра приложения
LPCTSTR lpTemplate , // идентифицирует имя шаблона диалогового окна