FreeReservedLog 函数 (clfsw32.h)

通过调用 ReserveAndAppendLog、ReserveAndAppendLogAligned 或 AllocReservedLog 减少封送处理区域中保留的日志记录数。使用此函数，客户端可以释放封送处理区域中保留的一组聚合记录和字节。

语法

CLFSUSER_API BOOL FreeReservedLog(
  [in, out] PVOID     pvMarshal,
  [in]      ULONG     cReservedRecords,
  [in, out] PLONGLONG pcbAdjustment
);

[in, out] pvMarshal

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

[in] cReservedRecords

要释放的保留记录数。

如果数调整的字节计数为正数， 则 cReservedRecords 是调整后剩余的保留记录总数。否则，此参数指定要从当前保留记录数中减去的记录数，但永远不能超过保留计数。

[in, out] pcbAdjustment

受调整影响的预留空间的字节数。

在输入时，如果此数字为正数，则指定调整后保留空间的总剩余大小。如果此参数为负数，则其绝对值为要释放的字节数。

此值通常是对以下内容的上一次调用中返回的实际保留空间的聚合：

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

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

保留记录时，将保留特定大小。释放这些记录时，必须释放相同的大小。