clfsw32.h 标头

此标头由数据访问和存储使用。 有关详细信息，请参阅：

• 数据访问和存储

clfsw32.h 包含以下编程接口：

函数

AddLogContainer 如果调用进程对 .blf 文件具有写入访问权限，并且能够在容器的目标目录中创建文件，则向与日志句柄关联的物理日志中添加容器。
AddLogContainerSet 如果调用进程有权访问日志句柄，则向与日志句柄关联的物理日志添加多个日志容器。
AdvanceLogBase 将日志流的基本日志序列号 (LSN) 提升到指定的 LSN。
AlignReservedLog 计算一组保留记录的扇区对齐预留大小。
AllocReservedLog 为一组保留记录分配扇区对齐的空间。
CloseAndResetLogFile 重置日志文件，然后关闭日志。
CreateLogContainerScanContext 创建一个扫描上下文，用于 ScanLogContainers 以枚举与日志关联的所有日志容器，并执行第一次扫描。
CreateLogFile 创建或打开日志。
CreateLogMarshallingArea 为日志创建封送处理区域，成功后返回封送处理上下文。 在创建封送处理区域之前，日志必须至少有一个容器。
DeleteLogByHandle 标记要删除的指定日志。 当关闭日志的所有句柄、封送区域和读取上下文时，实际上会删除日志。 如果日志是物理日志，则删除其基础容器。
DeleteLogFile 标记要删除的日志。 当关闭日志的所有句柄、封送区域和读取上下文时，实际上会删除日志。 如果日志是物理日志，则删除其基础容器。
DeleteLogMarshallingArea 删除通过成功调用 CreateLogMarshallingArea 创建的封送处理区域。
DumpLogRecords 扫描指定的日志;根据记录类型筛选日志记录;和 将记录放在调用方打开的输出文件流中。
FlushLogBuffers 强制追加到此封送处理区域的所有记录刷新到磁盘。
FlushLogToLsn 强制追加到此封送处理区域的所有记录，一直附加到具有指定日志序列号的记录 (LSN) 刷新到磁盘。 在此操作期间，可能会刷新超过指定的记录数。
FreeReservedLog 通过调用 ReserveAndAppendLog、ReserveAndAppendLogAligned 或 AllocReservedLog 减少封送处理区域中保留的日志记录数。
GetLogContainerName 检索指定容器的完整路径名称。
GetLogFileInformation 返回一个缓冲区，该缓冲区包含有关指定日志及其当前状态的元数据，该状态由 CLFS_INFORMATION 结构定义。
GetLogIoStatistics 检索与指定句柄关联的专用日志或多路复用日志的日志 I/O 统计信息。
GetNextLogArchiveExtent 检索日志存档上下文中的下一组存档区。
LsnBlockOffset 返回指定 LSN 中包含的扇区对齐块偏移量。
LsnContainer 检索包含在指定 LSN 中的逻辑容器 ID。
LsnCreate 在给定容器 ID、块偏移量和记录序列号的情况下， (LSN) 创建日志序列号。
LsnRecordSequence 检索包含在指定 LSN 中的记录序列号。
PrepareLogArchive 准备用于存档的物理日志。
ReadLogArchiveMetadata 将元数据的存档视图范围复制到指定的缓冲区。
ReadLogRecord 以三种模式之一从指定的日志序列号 (LSN) 启动读取序列，并返回指定的日志记录和读取上下文中的第一个。
ReadLogRestartArea 返回最后一个重启区域，该区域已成功写入与 WriteLogRestartArea 的封送处理区域关联的日志。
ReadNextLogRecord 读取通过调用 ReadLogRecord 或 ReadLogRestartArea 启动的序列中的下一条记录。
ReadPreviousLogRestartArea 读取与读取上下文 pvReadContext 中指定的当前重启记录相关的上一个日志重启区域。 此读取上下文是以前通过调用 ReadLogRestartArea 创建的上下文。
RemoveLogContainer 从与专用或多路复用日志句柄关联的日志中删除一个容器。
RemoveLogContainerSet 从与专用或多路复用日志句柄关联的日志中删除多个容器。
ReserveAndAppendLog 为日志缓冲区保留空间，或将日志记录追加到日志中，或同时执行这两项操作。 函数是原子函数。
ReserveAndAppendLogAligned 为日志缓冲区保留空间，或将日志记录追加到日志中，或同时追加两者。
ScanLogContainers 枚举日志容器。 重复调用此函数以循环访问所有日志容器。
SetEndOfLog 此函数已弃用。 请改用 TruncateLog。
SetLogArchiveMode 启用或禁用对指定日志的日志存档支持。
SetLogArchiveTail 设置上一个存档日志序列号 (LSN) 或存档的日志尾部。
TerminateLogArchive 解除分配最初由 PrepareLogArchive 为日志存档上下文分配的系统资源。
TerminateReadLog 终止读取上下文。 此函数释放与指定的读取上下文关联的系统分配的资源。 调用此函数后，请勿尝试读取日志记录;你将收到不确定的结果。
TruncateLog 截断日志。 函数将日志的末尾设置为指定的值。
ValidateLog 验证日志元数据和数据在日志存档之前和日志还原之后的一致性。
WriteLogRestartArea 将新的客户端重启区域追加到日志中，并选择性地将基本日志序列号 (LSN) 。