ILog::Metode ReadRecordPrefix (txlogpub.h)

Artikel
03/15/2023

Membaca bagian awal rekaman dari log.

Sintaks

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

Parameter

[in] lsnToRead

LSN catatan yang akan dibaca.

[in, out] plsnPrev

Penunjuk ke LSN rekaman sebelumnya (rekaman segera mendahului rekaman untuk dibaca). Anda dapat melewati NULL jika LSN dari rekaman sebelumnya tidak diperlukan. Parameter ini adalah 0 jika tidak ada rekaman sebelumnya dalam log atau jika terjadi kesalahan.

[in, out] plsnNext

Penunjuk ke LSN rekaman berikutnya (rekaman segera mengikuti rekaman untuk dibaca). Anda dapat melewati NULL jika LSN rekaman berikutnya tidak diperlukan. Parameter ini adalah MAXLSN (0x7FFFFFFFFFFFFFFF) jika tidak ada rekaman berikutnya dalam log. Parameter ini adalah 0 jika terjadi kesalahan.

[out] pbData

Penunjuk ke buffer tempat data rekaman akan dibaca.

[in, out] pcbData

Penunjuk ke variabel yang berisi ukuran dalam byte buffer pada input, dan akan berisi ukuran dalam byte data rekaman yang dibaca saat dikembalikan.

[out] pcbRecord

Penunjuk ke variabel yang akan berisi ukuran dalam byte dari seluruh rekaman yang dikembalikan. Anda dapat melewati NULL jika ukuran seluruh rekaman tidak diperlukan.

Mengembalikan nilai

Metode ini dapat mengembalikan nilai berikut, serta nilai HRESULT lainnya.

Menampilkan kode	Deskripsi
S_OK	Rekaman berhasil dibaca dari log.
XACT_E_INVALIDLSN	lsnToRead berada di luar batas log saat ini. Lihat ILog::GetLogLimits.
E_INVALIDARG	lsnToRead berada dalam batas log saat ini, tetapi bukan LSN rekaman dalam log.

Keterangan

Meskipun catatan yang ditambahkan ke log menggunakan ILog::AppendRecord dapat digabungkan dari beberapa BLOB, ReadRecordPrefix mengembalikan rekaman sebagai blob data buram tunggal. ILog tidak menyediakan metode untuk mengekstrak blob individual dari catatan. Penelepon bertanggung jawab untuk mengurai data dalam rekaman yang dikembalikan oleh ReadRecordPrefix.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	txlogpub.h

Lihat juga

ILog

Bagikan melalui