На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

FlushFileBuffers



The FlushFileBuffers function clears the buffers for the specified file and causes all buffered data to be written to the file.

BOOL FlushFileBuffers(

HANDLE hFile // open handle to file whose buffers are to be flushed
);


Parameters

hFile

An open file handle. The function flushes this file's buffers. The file handle must have GENERIC_WRITE access to the file.
If hFile is a handle to a communications device, the function only flushes the transmit buffer.
If hFile is a handle to the server end of a named pipe, the function does not return until the client has read all buffered data from the pipe.
Windows NT: The function fails if hFile is a handle to console output. That is because console output is not buffered. The function returns FALSE, and GetLastError returns ERROR_INVALID_HANDLE.

Windows 95: The function does nothing if hFile is a handle to console output. That is because console output is not buffered. The function returns TRUE, but it does nothing.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The WriteFile and WriteFileEx functions typically write data to an internal buffer that the operating system writes to disk on a regular basis. The FlushFileBuffers function writes all of the buffered information for the specified file to disk.
You can pass the same file handle used with the _lread, _lwrite, _lcreat, and related functions to FlushFileBuffers.

See Also

_lread, _lwrite, _lcreat, WriteFile, WriteFileEx


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

FlushFileBuffers



Функция FlushFileBuffers очищает буферы для определенного файла и вызывает все буферные данные, которые нужно записывать в файл.

BOOL FlushFileBuffers(

ОТКРЫТАЯ ручка РУЧКИ hFile // в файл чьи буферы должны быть сброшены
);


Параметры

hFile

Открытая файловая ручка. Функция сбрасывает эти файловые буферы. Файловая ручка должна иметь доступ GENERIC_WRITE к файлу.
Если hFile - ручка на устройстве связи, функция только сбрасывает буфер передачи.
Если hFile - ручка в конце сервера поименованной трубы, функция не возвращается пока клиент не прочитал все буферные данные из трубы.
Windows NT: функция терпит неудачу если hFile - ручка, чтобы утешать выход. Это - поскольку консольный выход не буферизован. Функция возвращает ЛОЖЬ, и возврат GetLastError ERROR_INVALID_HANDLE.

Windows 95: функция делает ничто если hFile - ручка, чтобы утешать выход. Это - поскольку консольный выход не буферизован. Функция возвращает ИСТИНУ, но это делает ничто.



Обратные Величины

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

Замечания

WriteFile И данные обычно записи функций WriteFileEx во внутренний буфер, что операционная система записывается на диск на регулярной основе. Функция FlushFileBuffers записывает все буферизовавшее информацию для определенного файла на диск.
Вы можете передать ту же файловую ручку использованную _lread, _lwrite, _lcreat, и связавшее функции на FlushFileBuffers.

Смотри Также

_lread, _lwrite, _lcreat, WriteFile, WriteFileEx


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz