AllocReservedLog function

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

Syntax


BOOL WINAPI AllocReservedLog(
  _Inout_ PVOID     pvMarshal,
  _In_    ULONG     cReservedRecords,
  _Inout_ PLONGLONG pcbAdjustment
);

Parameters

pvMarshal [in, out]

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

cReservedRecords [in]

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

This value must be greater than zero (0).

pcbAdjustment [in, out]

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:

ERROR_ACCESS_DENIED
ERROR_INVALID_HANDLE
ERROR_INVALID_PARAMETER
ERROR_INVALID_USER_BUFFER
ERROR_LOG_FULL
ERROR_NO_SYSTEM_RESOURCES

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 R2 [desktop apps only]

Header

Clfsw32.h

Library

Clfsw32.lib

DLL

Clfsw32.dll

See also

AlignReservedLog
Common Log File System Functions

 

 

Community Additions

ADD
Show: