AllocReservedLog function (clfsw32.h)

Allocates sector-aligned space for a set of reserved records. The requested allocation must be the same size that AlignReservedLog returns.

Syntax

CLFSUSER_API BOOL AllocReservedLog(
  [in, out] PVOID     pvMarshal,
  [in]      ULONG     cReservedRecords,
  [in, out] PLONGLONG pcbAdjustment
);

Parameters

[in, out] pvMarshal

A pointer to the marshaling context that is allocated by calling the CreateLogMarshallingArea function.

[in] cReservedRecords

The number of reserved records that are associated with the reservation adjustment.

This value must be greater than zero (0).

[in, out] pcbAdjustment

The size of the sector-aligned space reservation that is associated with the number of records specified in cReservedRecords, in bytes.

This parameter must be the aligned reservation size that AlignReservedLog returns in *pcbAlignReservation.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero (0). To get extended error information, call GetLastError. The following list identifies the possible error codes:

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 clfsw32.h
Library Clfsw32.lib
DLL Clfsw32.dll

See also

AlignReservedLog

Common Log File System Functions