Функция TxfLogReadRecords (txfw32.h)

Статья
03/03/2024

[Корпорация Майкрософт настоятельно рекомендует разработчикам использовать альтернативные средства для удовлетворения потребностей вашего приложения. Многие сценарии, для которые был разработан TxF, могут быть реализованы с помощью более простых и доступных методов. Кроме того, TxF может быть недоступен в будущих версиях Microsoft Windows. Дополнительные сведения и альтернативы TxF см. в статье Альтернативы использованию транзакционной NTFS.]

Считывает записи повтора из журнала.

Синтаксис

BOOL TxfLogReadRecords(
  [in]  PVOID  TxfLogContext,
  [in]  ULONG  BufferLength,
  [out] PVOID  Buffer,
  [out] PULONG BytesUsed,
  [out] PULONG RecordCount
);

Параметры

[in] TxfLogContext

Указатель на контекст.

[in] BufferLength

Размер выходного буфера в байтах.

[out] Buffer

Указатель на буфер, который получает записи. Дополнительные сведения см. в разделе TXF_LOG_RECORD_BASE.

[out] BytesUsed

Число байтов, записанных в выходной буфер.

[out] RecordCount

Количество записей, записываемых в выходной буфер.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

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

Код возврата	Описание
ERROR_INVALID_HANDLE	Недопустимый контекст репликации.
ERROR_MORE_DATA	Некоторые из доступных записей были скопированы в буфер. Снова вызовите эту функцию, чтобы получить остальные записи.
ERROR_INSUFFICIENT_BUFFER	Буфер недостаточно велик, чтобы вместить хотя бы одну запись. Если значение BytesUsed не равно нулям, для копирования структуры TXF_LOG_RECORD_BASE достаточно места, указывающего необходимый размер буфера для чтения следующей полной записи.
ERROR_FILE_CORRUPT	Формат обрабатываемого файла журнала не определен.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista с пакетом обновления 1 (SP1) [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	txfw32.h
Библиотека	TxfW32.lib
DLL	TxfW32.dll

См. также раздел

TXF_LOG_RECORD_BASE

Поделиться через