Функция HandleLogFull (clfsmgmtw32.h)
Функция HandleLogFull вызывается клиентом управляемого журнала, когда попытка резервирования или добавления в журнал завершается ошибкой с сообщением об ошибке "Полный журнал". Диспетчер журналов пытается разрешить полное условие журнала для клиента и уведомляет клиента, когда результат известен. В результате этого вызова размер журнала может быть увеличен.
Синтаксис
CLFSUSER_API BOOL HandleLogFull(
[in] HANDLE hLog
);
Параметры
[in] hLog
Дескриптор журнала, в котором необходимо разрешить полное условие журнала. Дескриптор должен быть зарегистрирован в RegisterManageableLogClient.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. Допустимые значения.
Комментарии
Если контейнеры создаются для разрешения условия полного ведения журнала, они создаются с использованием контекста безопасности вызывающего приложения.
HandleLogFull всегда приводит к асинхронной реакции или ошибке; Если возвращается значение false, а GetLastError возвращает ERROR_IO_PENDING, результатом является асинхронное поведение. Если запрос является асинхронным, клиенту отправляется уведомление, когда обработчик либо разрешил полное условие журнала, либо он завершается сбоем.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 R2 [только классические приложения] |
Целевая платформа | Windows |
Header | clfsmgmtw32.h |
Библиотека | Clfsw32.lib |
DLL | Clfsw32.dll |