Função FreeReservedLog (clfsw32.h)
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 |