Функция FlushViewOfFile пишет на диск блок байтов в пределах отображаемого вида файла.
Синтаксис
BOOL FlushViewOfFile( LPCVOID lpBaseAddress, // начальный адрес SIZE_T dwNumberOfBytesToFlush // число байтов в блоке ); |
Параметры
lpBaseAddress
[in] Указатель на базовый адрес блока байтов, который сбрасывается на дисковый образ отображаемого файла.dwNumberOfBytesToFlush
[in] Сбрасываемое число байтов. Если параметр dwNumberOfBytesToFlush равняется нулю, файл сбрасывается от базового адреса до конца отображения.Возвращаемые значения
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.
Замечания
Сбрасывание на диск блока отображаемого вида заставляет любые недействительные страницы в пределах этого блока записываться на диск. Недействительные страницы - это страницы, содержание которых изменилось, так как вид файла преобразовывался.
При сбрасывании на диск отображенного в памяти файла по сети, FlushViewOfFile гарантирует, что данные записались из локального компьютера, но не гарантирует, что данные находятся на удаленном компьютере. Сервер может кэшировать данные на удаленном конце. Поэтому, функция FlushViewOfFile может возвратить значение прежде, чем данные были физически написаны на диск. Однако, Вы можете заставить FlushViewOfFile возвращать значение только тогда, когда закончена физическая запись, определяя флажок FILE_FLAG_WRITE_THROUGH, открывая файл функцией CreateFile.
Код примера
Пример см в статье Чтение и запись из представления данных файла.
Смотри также
Обзор Управление файлами, Функции, используемые для отображения файла в память, CreateFile, MapViewOfFile, UnmapViewOfFile
|
Размещение и совместимость FlushViewOfFile |
||
| К |
Windows XP |
Да |
| л |
Windows 2000 Professional |
Да |
| и |
Windows NT Workstation |
Да |
| е |
Windows Me |
Да |
| н |
Windows 98 |
Да |
| т |
Windows 95 |
Да |
| С |
Windows Server 2003 |
Да |
| е | Windows 2000 Server | Да |
| р | Windows NT Server | Да |
| в | ||
| е | ||
| р | ||
|
Используемая библиотека |
Kernel32.lib |
|
| Используемая DLL | - | |
| Заголовочный файл | ||
|
- объявлено в |
Winbase.h |
|
| - включено в |
Windows.h |
|
| Unicode |
Нет |
|
| Замечания по платформе |
Не имеется |
|