ICrmCompensator::P repareRecord-Methode (comsvcs.h)
Übermittelt während der Vorbereitungsphase einen Protokolldatensatz in der Reihenfolge der Übertragung. Diese Methode kann vom CRM-Kompensator mehrmals empfangen werden, einmal für jeden geschriebenen Protokolldatensatz.
Syntax
HRESULT PrepareRecord(
[in] CrmLogRecordRead crmLogRec,
[out] BOOL *pfForget
);
Parameter
[in] crmLogRec
Der Protokolldatensatz als CrmLogRecordRead-Struktur .
[out] pfForget
Gibt an, ob der übermittelte Datensatz vergessen werden soll.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Unstrukturierte Protokolldatensätze werden als CrmLogRecordRead-Struktur bereitgestellt. Zusätzlich zu den Benutzerdaten (als einzelnes BLOB) enthält diese Struktur einige zusätzliche Felder, die für das Debuggen oder Die Fehlersuche nützlich sein können, wenn eine menschliche Kompensation erforderlich ist. Der dwCrmFlags-Member ist ein Bitfeld, das weitere Informationen darüber bereitstellt, ob dieser Datensatz zu einem bestimmten Zeitpunkt vergessen wurde und wann er geschrieben wurde. Das dwSequenceNumber-Element stellt die Sequenznummer des Protokolldatensatzes bereit. In den meisten Fällen sind Sequenznummern sequenziell, aber aufgrund interner Protokolldatensätze, die nicht an den CRM-Kompensator übermittelt werden, nicht unbedingt zusammenhängend.
Wenn vom CRM Worker keine Protokolldatensätze geschrieben werden, werden die Methoden BeginPrepare und EndPrepare empfangen, es gibt jedoch keine Aufrufe der PrepareRecord-Methode . Dies ist, um CRM-Kompensatoren zuzulassen, die Protokolldatensätze nur zur Vorbereitungszeit schreiben.
Der CRM-Kompensator kann den Datensatz vergessen, der während dieser Phase an ihn übermittelt wird, indem er das Flag "Vergessen" bei der Rückgabe von dieser Methode festlegt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | comsvcs.h |