Функция 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

Количество зарезервированных записей для освобождения.

Если число байтов корректировки в pcbAdjustment является положительным , cReservedRecords — это общее количество зарезервированных записей, оставшихся после корректировки. В противном случае этот параметр указывает количество записей, которые необходимо вычесть из текущего числа зарезервированных записей, но никогда не может превышать зарезервированное число.

[in, out] pcbAdjustment

Количество байтов пространства резервирования, на которое влияет корректировка.

При входных данных, если это число положительное, оно указывает общий оставшийся размер зарезервированного пространства после корректировки. Если этот параметр является отрицательным, его абсолютным значением является число освобождаемых байтов.

Обычно это значение является агрегированным фактическим зарезервированным пространством, которое возвращается в предыдущем вызове следующего:

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. В следующем списке указаны возможные коды ошибок:

Комментарии

При резервировании записей вы резервируйте определенный размер. При освобождении этих записей необходимо освободить тот же размер.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 R2 [только классические приложения]
Целевая платформа Windows
Header clfsw32.h
Библиотека Clfsw32.lib
DLL Clfsw32.dll

См. также раздел

Общие функции файловой системы журнала