AlignReservedLog 函数 (clfsw32.h)

计算一组保留记录的扇区对齐预留大小。 然后,此值将传递给 AllocReservedLog ,以便为一组记录保留日志空间块。

语法

CLFSUSER_API BOOL AlignReservedLog(
  [in, out] PVOID       pvMarshal,
  [in]      ULONG       cReservedRecords,
  [in]      LONGLONG [] rgcbReservation,
  [out]     PLONGLONG   pcbAlignReservation
);

参数

[in, out] pvMarshal

指向通过调用 CreateLogMarshallingArea 函数分配的不透明封送处理上下文的指针。

[in] cReservedRecords

与预留调整关联的保留记录数。

[in] rgcbReservation

要保留在与当前封送处理上下文关联的日志中的空间分配数组(以字节为单位)。

分配数对应于 cReservedRecords 指定的记录数。 每个分配必须大于零 (0) 否则函数失败并 出现ERROR_INVALID_PARAMETER

[out] pcbAlignReservation

指向变量的指针,在该变量中,函数在给定 cRecords 指定的记录数和 rgcbReservation 数组中指定的预留大小后,返回日志中要保留的扇区对齐字节空间的数量。

在 *2016 年 *2016 年*2016 年返回的值用作 AllocReservedLog 的输入。 如果 AllocReservedLog 成功,此值始终大于零 (0) 。 如果 AllocReservedLog 失败,则该值为零 (0) 。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零 (0)。 要获得更多的错误信息,请调用 GetLastError。 以下列表标识了可能的错误代码:

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 R2 [仅限桌面应用]
目标平台 Windows
标头 clfsw32.h
Library Clfsw32.lib
DLL Clfsw32.dll

另请参阅

AllocReservedLog

常见日志文件系统函数