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

Значение, возвращаемое в *pcbAlignReservation , используется в качестве входных данных для AllocReservedLog. Если allocReservedLog выполняется успешно, это значение всегда больше нуля (0). Если AllocReservedLog завершается сбоем, значение равно нулю (0).

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

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

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

Требования

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

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

AllocReservedLog

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