HandleLogFull function (clfsmgmtw32.h)

The HandleLogFull function is called by a managed log client when an attempt to reserve or append to a log fails with a log full error message. The log manager attempts to resolve the log full condition for the client, and notifies the client when the outcome is known. As a result of this call, the log may get larger in size.

Syntax

CLFSUSER_API BOOL HandleLogFull(
  [in] HANDLE hLog
);

Parameters

[in] hLog

A handle to the log on which to resolve the log full condition. The handle must have been registered with RegisterManageableLogClient.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError. Valid values include the following:

Remarks

If containers are created to resolve a log-full condition, they are created using the calling application's security context.

HandleLogFull always results in asynchronous behavior or an error; if it returns false and GetLastError returns ERROR_IO_PENDING, the result is asynchronous behavior. If a request is asynchronous, a notification is sent to the client when the handler has either resolved the log full condition or it fails.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 R2 [desktop apps only]
Target Platform	Windows
Header	clfsmgmtw32.h
Library	Clfsw32.lib
DLL	Clfsw32.dll