Função FreeReservedLog (clfsw32.h)

  • Artigo

Reduz o número de registros de log reservados em uma área de marshaling feita chamando ReserveAndAppendLog, ReserveAndAppendLogAligned ou AllocReservedLog. Usando essa função, os clientes podem liberar um conjunto agregado de registros e bytes reservados na área de marshaling.

Sintaxe

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

Parâmetros

[in, out] pvMarshal

Um ponteiro para o contexto de marshaling opaco alocado usando a função CreateLogMarshallingArea .

[in] cReservedRecords

O número de registros reservados a serem liberados.

Se a contagem de bytes do ajuste em pcbAdjustment for positiva, cReservedRecords será o número total de registros reservados restantes após o ajuste. Caso contrário, esse parâmetro especifica o número de registros a serem subtraídos do número atual de registros reservados, mas nunca poderá exceder a contagem reservada.

[in, out] pcbAdjustment

O número de bytes de espaço de reserva afetados pelo ajuste.

Na entrada, se esse número for positivo, ele especificará o tamanho total restante do espaço reservado após o ajuste. Se esse parâmetro for negativo, seu valor absoluto será o número de bytes a serem liberados.

Esse valor geralmente é uma agregação do espaço reservado real que é retornado em uma chamada anterior para o seguinte:

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. A lista a seguir identifica os possíveis códigos de erro:

Comentários

Ao reservar registros, você reserva um tamanho específico. Ao liberar esses registros, você deve liberar o mesmo tamanho.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho clfsw32.h
Biblioteca Clfsw32.lib
DLL Clfsw32.dll

Confira também

Funções comuns do sistema de arquivos de log