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

Метод ILog::ReadRecordPrefix (txlogpub.h)

  • Статья

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

Синтаксис

HRESULT ReadRecordPrefix(
  [in]      LSN   lsnToRead,
  [in, out] LSN   *plsnPrev,
  [in, out] LSN   *plsnNext,
  [out]     BYTE  *pbData,
  [in, out] ULONG *pcbData,
  [out]     ULONG *pcbRecord
);

Параметры

[in] lsnToRead

Номер LSN считываемой записи.

[in, out] plsnPrev

Указатель на номер LSN предыдущей записи (непосредственно перед записью для чтения). Если номер LSN предыдущей записи не требуется, можно передать значение NULL . Этот параметр имеет значение 0, если в журнале нет предыдущей записи или возникает ошибка.

[in, out] plsnNext

Указатель на номер LSN следующей записи (запись сразу после считываемой записи). Если номер LSN следующей записи не требуется, можно передать значение NULL . Если в журнале нет следующей записи, этот параметр имеет значение MAXLSN (0x7FFFFFFFFFFFFFFF). Этот параметр имеет значение 0, если возникает ошибка.

[out] pbData

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

[in, out] pcbData

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

[out] pcbRecord

Указатель на переменную, которая будет содержать размер всей записи в байтах при возврате. Если размер всей записи не требуется, можно передать значение NULL .

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

Этот метод может возвращать следующие значения, а также другие значения HRESULT .

Код возврата Описание
S_OK
 Запись успешно считана из журнала.
XACT_E_INVALIDLSN
 Значение lsnToRead выходит за пределы текущего журнала. См. раздел ILog::GetLogLimits.
E_INVALIDARG
 Значение lsnToRead находится в пределах текущих ограничений журнала, но не является номером LSN записи в журнале.

Комментарии

Хотя записи, добавленные в журнал с помощью ILog::AppendRecord , могут быть сцеплены из нескольких BLOB-объектов, ReadRecordPrefix возвращает запись в виде одного непрозрачного большого двоичного объекта данных. ILog не предоставляет метод извлечения отдельных BLOB-объектов из записи. Вызывающий объект отвечает за анализ данных в записях, возвращаемых ReadRecordPrefix.

Требования

   
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header txlogpub.h

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

ILog