Función FreeReservedLog (clfsw32.h)

Reduce el número de registros reservados en un área de serialización realizada mediante una llamada a ReserveAndAppendLog, ReserveAndAppendLogAligned o AllocReservedLog. Con esta función, los clientes pueden liberar un conjunto agregado de registros y bytes reservados en el área de cálculo de referencias.

Sintaxis

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

Parámetros

[in, out] pvMarshal

Puntero al contexto de serialización opaco asignado mediante la función CreateLogMarshallingArea .

[in] cReservedRecords

Número de registros reservados que se liberarán.

Si el recuento de bytes del ajuste en pcbAdjustment es positivo, cReservedRecords es el número total de registros reservados que quedan después del ajuste. De lo contrario, este parámetro especifica el número de registros que se van a restar del número actual de registros reservados, pero nunca puede superar el recuento reservado.

[in, out] pcbAdjustment

Número de bytes de espacio de reserva afectado por el ajuste.

En la entrada, si este número es positivo, especifica el tamaño total restante del espacio reservado después del ajuste. Si este parámetro es negativo, su valor absoluto es el número de bytes que se liberarán.

Este valor suele ser un agregado del espacio reservado real que se devuelve en una llamada anterior a lo siguiente:

• ReserveAndAppendLog
• ReserveAndAppendLogAligned
• AllocReservedLog

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. En la lista siguiente se identifican los posibles códigos de error:

Comentarios

Al reservar registros, se reserva un tamaño específico. Al liberar esos registros, debe liberar el mismo tamaño.

Requisitos

Consulte también

Funciones comunes del sistema de archivos de registro