Funzione FreeReservedLog (clfsw32.h)

Riduce il numero di record di log riservati in un'area di marshalling effettuata chiamando ReserveAndAppendLog, ReserveAndAppendLogAligned o AllocReservedLog. Usando questa funzione, i client possono liberare un set aggregato di record e byte riservati nell'area di marshalling.

Sintassi

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

Parametri

[in, out] pvMarshal

Puntatore al contesto di marshalling opaco allocato usando la funzione CreateLogMarshallingArea .

[in] cReservedRecords

Numero di record riservati da liberare.

Se il numero di byte della regolazione nel pcbAdjustment è positivo, cReservedRecords è il numero totale di record riservati rimanenti dopo l'adattamento. In caso contrario, questo parametro specifica il numero di record da sottrarre dal numero corrente di record riservati, ma non può mai superare il conteggio riservato.

[in, out] pcbAdjustment

Numero di byte dello spazio di prenotazione interessato dalla regolazione.

In input, se questo numero è positivo, specifica le dimensioni rimanenti totali dello spazio riservato dopo la regolazione. Se questo parametro è negativo, il relativo valore assoluto è il numero di byte da liberare.

Questo valore è in genere un'aggregazione dello spazio riservato effettivo restituito in una chiamata precedente al seguente:

• ReserveAndAppendLog
• ReserveAndAppendLogAligned
• AllocReservedLog

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. L'elenco seguente identifica i possibili codici di errore:

Commenti

Quando si riservano i record, si riservano dimensioni specifiche. Quando si liberano questi record, è necessario liberare le stesse dimensioni.

Requisiti

Vedi anche

Funzioni comuni del file system di log