TxfLogReadRecords-Funktion (txfw32.h)

Artikel
08/26/2023

[Microsoft empfiehlt Entwicklern dringend, alternative Mittel zu verwenden, um die Anforderungen Ihrer Anwendung zu erfüllen. Viele Szenarios, für die TxF entwickelt wurde, können mit einfacheren und leichter verfügbaren Techniken erreicht werden. Darüber hinaus ist TxF in zukünftigen Versionen von Microsoft Windows möglicherweise nicht verfügbar. Weitere Informationen und Alternativen zu TxF finden Sie unter Alternativen zur Verwendung von transaktionalem NTFS.]

Liest die Wiederholungsdatensätze aus dem Protokoll.

Syntax

BOOL TxfLogReadRecords(
  [in]  PVOID  TxfLogContext,
  [in]  ULONG  BufferLength,
  [out] PVOID  Buffer,
  [out] PULONG BytesUsed,
  [out] PULONG RecordCount
);

Parameter

[in] TxfLogContext

Ein Zeiger auf den Kontext.

[in] BufferLength

Die Größe des Ausgabepuffers in Bytes.

[out] Buffer

Ein Zeiger auf den Puffer, der die Datensätze empfängt. Weitere Informationen finden Sie unter TXF_LOG_RECORD_BASE.

[out] BytesUsed

Die Anzahl der Bytes, die in den Ausgabepuffer geschrieben werden.

[out] RecordCount

Die Anzahl der Datensätze, die in den Ausgabepuffer geschrieben werden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Mögliche Fehlercodes sind:

Rückgabecode	Beschreibung
ERROR_INVALID_HANDLE	Der Replikationskontext ist ungültig.
ERROR_MORE_DATA	Einige der verfügbaren Datensätze wurden in den Puffer kopiert. Rufen Sie diese Funktion erneut auf, um die restlichen Datensätze abzurufen.
ERROR_INSUFFICIENT_BUFFER	Der Puffer ist nicht groß genug, um auch nur einen Datensatz zu enthalten. Wenn BytesUsed ungleich null ist, war genügend Speicherplatz zum Kopieren der TXF_LOG_RECORD_BASE-Struktur vorhanden, was die erforderliche Puffergröße zum Lesen des nächsten vollständigen Datensatzes angibt.
ERROR_FILE_CORRUPT	Das Format der zu verarbeitenden Protokolldatei ist unbekannt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista mit SP1 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	txfw32.h
Bibliothek	TxfW32.lib
DLL	TxfW32.dll

Weitere Informationen

TXF_LOG_RECORD_BASE

Freigeben über