clfsw32.h-Header

Dieser Header wird von Datenzugriff und Speicher verwendet. Weitere Informationen finden Sie unter

• Datenzugriff und -speicherung

clfsw32.h enthält die folgenden Programmierschnittstellen:

Functions

AddLogContainer Fügt dem physischen Protokoll, das dem Protokollhandle zugeordnet ist, einen Container hinzu, wenn der aufrufende Prozess Über Schreibzugriff auf die BLF-Datei und die Möglichkeit verfügt, Dateien im Zielverzeichnis des Containers zu erstellen.
AddLogContainerSet Fügt dem physischen Protokoll, das dem Protokollhandle zugeordnet ist, mehrere Protokollcontainer hinzu, wenn der aufrufende Prozess Zugriff auf das Protokollhandle hat.
AdvanceLogBase Erhöht die Basisprotokollsequenznummer (Base Log Sequence Number, LSN) eines Protokolldatenstroms auf die angegebene LSN.
AlignReservedLog Berechnet die sektorbezogene Reservierungsgröße für einen Satz reservierter Datensätze.
AllocReservedLog Ordnet sektorbezogenen Speicherplatz für eine Reihe reservierter Datensätze zu.
CloseAndResetLogFile Setzt die Protokolldatei zurück und schließt dann das Protokoll.
CreateLogContainerScanContext Erstellt einen Scankontext, der mit ScanLogContainers verwendet werden soll, um alle Protokollcontainer aufzulisten, die einem Protokoll zugeordnet sind, und führt die erste Überprüfung durch.
CreateLogFile Erstellt oder öffnet ein Protokoll.
CreateLogMarshallingArea Erstellt einen Marshallingbereich für ein Protokoll und gibt bei erfolgreicher Ausführung einen Marshallingkontext zurück. Vor dem Erstellen eines Marshallingbereichs muss das Protokoll über mindestens einen Container verfügen.
DeleteLogByHandle Markiert das angegebene Protokoll zum Löschen. Das Protokoll wird tatsächlich gelöscht, wenn alle Handles, Marshallingbereiche und Lesekontexte für das Protokoll geschlossen werden. Wenn das Protokoll ein physisches Protokoll ist, werden die zugrunde liegenden Container gelöscht.
DeleteLogFile Markiert ein Protokoll zum Löschen. Das Protokoll wird tatsächlich gelöscht, wenn alle Handles, Marshallingbereiche und Lesekontexte für das Protokoll geschlossen werden. Wenn das Protokoll ein physisches Protokoll ist, werden die zugrunde liegenden Container gelöscht.
DeleteLogMarshallingArea Löscht einen Marshallingbereich, der durch einen erfolgreichen Aufruf von CreateLogMarshallingArea erstellt wird.
DumpLogRecords Scannt ein angegebenes Protokoll; filtert Protokolldatensätze basierend auf dem Datensatztyp; und platziert die Datensätze in einem Ausgabedateidatenstrom, den der Aufrufer öffnet.
FlushLogBuffers Erzwingt, dass alle Datensätze, die an diesen Marshallingbereich angefügt werden, auf den Datenträger geleert werden.
FlushLogToLsn Erzwingt, dass alle Datensätze, die an diesen Marshallingbereich angefügt werden, bis zum Datensatz mit der angegebenen Protokollsequenznummer (Log Sequence Number, LSN) auf den Datenträger geleert werden. Während dieses Vorgangs können mehr Datensätze als angegeben geleert werden.
FreeReservedLog Reduziert die Anzahl der reservierten Protokolldatensätze in einem Marshallingbereich, der durch Aufrufen von ReserveAndAppendLog, ReserveAndAppendLogAligned oder AllocReservedLog erstellt wird.
GetLogContainerName Ruft den vollständigen Pfadnamen des angegebenen Containers ab.
GetLogFileInformation Gibt einen Puffer zurück, der Metadaten zu einem angegebenen Protokoll und dessen aktuellem Zustand enthält, der durch die CLFS_INFORMATION-Struktur definiert wird.
GetLogIoStatistics Ruft Protokoll-E/A-Statistiken für ein dediziertes oder multiplexiertes Protokoll ab, das dem angegebenen Handle zugeordnet ist.
GetNextLogArchiveExtent Ruft den nächsten Satz von Archivausdehnungen in einem Protokollarchivkontext ab.
LsnBlockOffset Gibt den sektorbezogenen Blockoffset zurück, der in der angegebenen LSN enthalten ist.
LsnContainer Ruft die logische Container-ID ab, die in einer angegebenen LSN enthalten ist.
LsnErstellen Erstellt eine Protokollsequenznummer (Log Sequence Number, LSN), die eine Container-ID, einen Blockoffset und eine Datensatzsequenznummer enthält.
LsnRecordSequence Ruft die Datensatzsequenznummer ab, die in einer angegebenen LSN enthalten ist.
PrepareLogArchive Bereitet ein physisches Protokoll für die Archivierung vor.
ReadLogArchiveMetadata Kopiert einen Bereich der Archivansicht der Metadaten in den angegebenen Puffer.
ReadLogRecord Initiiert eine Sequenz von Lesevorgängen aus einer angegebenen Protokollsequenznummer (Log Sequence Number, LSN) in einem von drei Modi und gibt den ersten der angegebenen Protokolldatensätze und einen Lesekontext zurück.
ReadLogRestartArea Gibt den letzten Neustartbereich zurück, der erfolgreich in das Protokoll geschrieben wurde, das dem Marshallingbereich von WriteLogRestartArea zugeordnet ist.
ReadNextLogRecord Liest den nächsten Datensatz in einer Sequenz, die durch einen Aufruf von ReadLogRecord oder ReadLogRestartArea initiiert wird.
ReadPreviousLogRestartArea Liest den vorherigen Protokollneustartbereich, der relativ zum aktuellen Neustartdatensatz ist, der im Lesekontext pvReadContext angegeben ist. Dieser Lesekontext wurde zuvor durch einen Aufruf von ReadLogRestartArea erstellt.
RemoveLogContainer Entfernt einen Container aus einem Protokoll, der einem dedizierten oder multiplexten Protokollhandle zugeordnet ist.
RemoveLogContainerSet Entfernt mehrere Container aus einem Protokoll, das einem dedizierten oder multiplexten Protokollhandle zugeordnet ist.
ReserveAndAppendLog Reserviert Speicherplatz für Protokollpuffer oder fügt einen Protokolldatensatz an das Protokoll an oder führt beides aus. Die Funktion ist atomar.
ReserveAndAppendLogAligned Reserviert Speicherplatz für Protokollpuffer oder fügt einen Protokolldatensatz an das Protokoll an, oder beides.
ScanLogContainers Listet Protokollcontainer auf. Rufen Sie diese Funktion wiederholt auf, um alle Protokollcontainer zu durchlaufen.
SetEndOfLog Diese Funktion ist veraltet. Verwenden Sie stattdessen TruncateLog.
SetLogArchiveMode Aktiviert oder deaktiviert die Unterstützung der Protokollarchivierung für ein angegebenes Protokoll.
SetLogArchiveTail Legt die letzte archivierte Protokollsequenznummer (LSN) oder das Archivfragment eines archivierbaren Protokolls fest.
TerminateLogArchive Gibt die Zuordnung von Systemressourcen auf, die ursprünglich von PrepareLogArchive für einen Protokollarchivkontext zugeordnet wurden.
TerminateReadLog Beendet einen Lesekontext. Diese Funktion gibt vom System zugeordnete Ressourcen frei, die dem angegebenen Lesekontext zugeordnet sind. Versuchen Sie nicht, Protokolldatensätze nach dem Aufruf dieser Funktion zu lesen. Sie erhalten unbestimmte Ergebnisse.
TruncateLog Schneidet das Protokoll ab. Die Funktion legt das Ende des Protokolls auf den angegebenen Wert fest.
ValidateLog Überprüft die Konsistenz der Protokollmetadaten und -daten vor der Protokollarchivierung und nach der Protokollwiederherstellung.
WriteLogRestartArea Fügt einen neuen Clientneustartbereich an ein Protokoll an und erhöht optional die Basisprotokollsequenznummer (Base Log Sequence Number, LSN) des Protokolls.