Метод ILog::Force (txlogpub.h)
Принудительное копирование содержимого журнала на диск по крайней мере через указанный номер LSN.
Синтаксис
HRESULT Force(
[in] LSN lsnMinToForce
);
Параметры
[in] lsnMinToForce
По крайней мере, все записи, которые еще не были записаны на диск с номером LSN меньше или равным lsnMinToForce , должны быть записаны на диск сейчас. Однако реализация может записать больше записей, чем требуется. Например, реализация допускает принудительное использование всех записей на диск независимо от значения lsnMinToForce. Передача 0 в качестве lsnMinToForce означает, что весь журнал должен быть принудительно установлен на диск.
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
После добавления отдельных записей журнал также может быть принудительно на диск. См. раздел ILog::AppendRecord.
Примечания к вызывающим абонентам
Возвращаемое значение сбоя указывает, что все записи, добавленные в журнал с момента последнего успешного принудительного выполнения, не гарантированно находятся на диске. Интерфейс ILog не предоставляет метод для определения записей, которые были успешно записаны на диск. Если необходимо знать, какие записи были успешно записаны на диск, необходимо принудительно вводить журнал для каждой записи. См. раздел ILog::AppendRecord.Примечания для разработчиков
Перед возвратом из этого метода рекомендуется очистить буферы файлов (например, с помощью функции FlushFileBuffers ).Требования
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | txlogpub.h |