ILog::Metode paksa (txlogpub.h)

Memaksa konten log ke disk, setidaknya hingga melalui LSN yang ditentukan.

Sintaks

HRESULT Force(
  [in] LSN lsnMinToForce
);

Parameter

[in] lsnMinToForce

Setidaknya, semua catatan yang belum ditulis ke disk dengan LSN kurang dari atau sama dengan lsnMinToForce harus ditulis ke disk sekarang. Implementasi dapat, bagaimanapun, memilih untuk menulis lebih banyak rekaman daripada apa yang benar-benar diperlukan. Misalnya, implementasi diizinkan untuk memaksa semua rekaman ke disk, terlepas dari nilai lsnMinToForce. Meneruskan 0 sebagai lsnMinToForce menunjukkan bahwa seluruh log harus dipaksa ke disk.

Nilai kembali

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Log juga dapat dipaksa untuk disk setelah menambahkan rekaman individual. Lihat ILog::AppendRecord.

Catatan untuk Penelepon

Nilai pengembalian kegagalan menunjukkan bahwa setiap rekaman yang ditambahkan ke log sejak terakhir kali berhasil dipaksa tidak dijamin berada di disk. Antarmuka ILog tidak menyediakan metode untuk menentukan rekaman mana yang berhasil ditulis ke disk. Jika Anda perlu mengetahui rekaman mana yang berhasil ditulis ke disk, Anda harus memaksa log untuk setiap rekaman. Lihat ILog::AppendRecord.

Catatan untuk Pelaksana

Disarankan agar Anda membersihkan buffer file (misalnya, menggunakan fungsi FlushFileBuffers ) sebelum kembali dari metode ini.

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

FlushFileBuffers

ILog