Metode ICrmCompensator::P repareRecord (comsvcs.h)

Mengirimkan catatan log dalam urutan penerusan selama fase persiapan. Metode ini dapat diterima oleh CRM Compensator beberapa kali, sekali untuk setiap rekaman log yang ditulis.

Sintaks

HRESULT PrepareRecord(
  [in]  CrmLogRecordRead crmLogRec,
  [out] BOOL             *pfForget
);

Parameter

[in] crmLogRec

Catatan log, sebagai struktur CrmLogRecordRead .

[out] pfForget

Menunjukkan apakah rekaman yang dikirim harus dilupakan.

Mengembalikan nilai

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

Keterangan

Rekaman log yang tidak terstruktur dikirimkan sebagai struktur CrmLogRecordRead . Selain data pengguna (sebagai BLOB tunggal), struktur ini berisi beberapa bidang tambahan yang mungkin berguna untuk penelusuran kesalahan atau pencarian kesalahan jika kompensasi manusia diperlukan. Anggota dwCrmFlags adalah bitfield yang memberikan informasi lebih lanjut tentang apakah catatan ini dilupakan pada titik tertentu dan kapan ditulis. Anggota dwSequenceNumber menyediakan nomor urut rekaman log. Dalam kebanyakan kasus, nomor urut berurutan tetapi belum tentu berdampingan karena catatan log internal yang tidak dikirimkan ke CRM Compensator.

Jika tidak ada catatan log yang ditulis oleh Pekerja CRM, metode BeginPrepare dan EndPrepare diterima tetapi tidak ada panggilan metode PrepareRecord . Ini untuk memungkinkan Kompensator CRM yang menulis rekaman log hanya pada waktu persiapan.

CRM Compensator dapat memilih untuk melupakan rekaman yang dikirimkan ke dalamnya selama fase ini dengan mengatur bendera lupa saat pengembalian dari metode ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	comsvcs.h

Lihat juga

ICrmCompensator