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:
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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 R2 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | clfsw32.h |
| Libreria | Clfsw32.lib |
| DLL | Clfsw32.dll |