Функция AddLogContainer (clfsw32.h)

  • Статья

Добавляет контейнер в физический журнал, связанный с дескриптором журнала, если вызывающий процесс имеет доступ на запись к BLF-файлу и возможность создавать файлы в целевом каталоге контейнера.

Эта функция отличается от AddLogContainerSet, так как она добавляет только один контейнер. Чтобы добавить несколько контейнеров, эффективнее использовать AddLogContainerSet, который позволяет добавить несколько контейнеров. Добавление контейнеров позволяет клиенту увеличить размер журнала.

Синтаксис

CLFSUSER_API BOOL AddLogContainer(
  [in]                HANDLE     hLog,
  [in, optional]      PULONGLONG pcbContainer,
  [in]                LPWSTR     pwszContainerPath,
  [in, out, optional] LPVOID     pReserved
);

Параметры

[in] hLog

Дескриптор открытого журнала.

Дескриптор должен быть получен из CreateLogFile с доступом на запись в журнал. Клиентское приложение должно иметь доступ на запись к BLF-файлу и возможность создавать файлы в целевом каталоге контейнера.

[in, optional] pcbContainer

Необязательный параметр, указывающий размер контейнера в байтах.

Минимальный размер составляет 512 КБ для обычных журналов и 1024 КБ для мультиплексированных журналов. Максимальный размер составляет приблизительно 4 гигабайта.

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

Размеры контейнеров журналов кратны размеру региона журнала (512 КБ). При добавлении контейнера в новый файл функция AddLogContainer округляет размер контейнера до следующей границы в 512 КБ и возвращает этот размер в значении, на которое указывает pcbContainer.

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

[in] pwszContainerPath

Указатель на строку, завершающуюся значением NULL, которая содержит допустимый путь для нового контейнера в томе журнала.

[in, out, optional] pReserved

Зарезервировано. Задайте для параметра pReserved значение NULL.

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

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

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

В следующем списке указаны возможные коды ошибок:

Требования

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

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

AddLogContainerSet

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

CreateLogFile