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 |