ICrmCompensator::P repareRecord メソッド (comsvcs.h)
準備フェーズ時にログ レコードを転送順に配信します。 このメソッドは、書き込まれたログ レコードごとに 1 回、CRM 補正器によって複数回受信できます。
構文
HRESULT PrepareRecord(
[in] CrmLogRecordRead crmLogRec,
[out] BOOL *pfForget
);
パラメーター
[in] crmLogRec
CrmLogRecordRead 構造体としてのログ レコード。
[out] pfForget
配信されたレコードを忘れるかどうかを示します。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
非構造化ログ レコードは、 CrmLogRecordRead 構造体として配信されます。 この構造体には、ユーザー データ (1 つの BLOB として) に加えて、人間の補償が必要な場合のデバッグやエラー検出に役立つ可能性がある追加のフィールドがいくつか含まれています。 dwCrmFlags メンバーはビットフィールドであり、このレコードがある時点で忘れられたかどうか、およびいつ書き込まれたかについての詳細情報を提供します。 dwSequenceNumber メンバーは、ログ レコードのシーケンス番号を提供します。 ほとんどの場合、シーケンス番号はシーケンシャルですが、CRM 補正器に配信されない内部ログ レコードが原因で連続しているとは限りません。
CRM Worker によってログ レコードが書き込まれない場合、 BeginPrepare メソッドと EndPrepare メソッドは受信されますが、 PrepareRecord メソッドの呼び出しはありません。 これは、準備時にのみログ レコードを書き込む CRM 補正機能を可能にするためです。
CRM 補正器は、このメソッドからの戻り時に忘れるフラグを設定することで、このフェーズ中に配信されるレコードを忘れるかどうかを選択できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | comsvcs.h |