FreeReservedLog-Funktion (clfsw32.h)
Reduziert die Anzahl der reservierten Protokolldatensätze in einem Marshallingbereich, der durch Aufrufen von ReserveAndAppendLog, ReserveAndAppendLogAligned oder AllocReservedLog erstellt wird. Mithilfe dieser Funktion können Clients einen Aggregatsatz von Datensätzen und Bytes freigeben, die im Marshallingbereich reserviert sind.
Syntax
CLFSUSER_API BOOL FreeReservedLog(
[in, out] PVOID pvMarshal,
[in] ULONG cReservedRecords,
[in, out] PLONGLONG pcbAdjustment
);
Parameter
[in, out] pvMarshal
Ein Zeiger auf den undurchsichtigen Marshallingkontext, der mithilfe der CreateLogMarshallingArea-Funktion zugeordnet wird.
[in] cReservedRecords
Die Anzahl der reservierten Datensätze, die freigegeben werden sollen.
Wenn die Byteanzahl der Anpassung in pcbAdjustment positiv ist, ist cReservedRecords die Gesamtzahl der reservierten Datensätze, die nach der Anpassung verbleiben. Andernfalls gibt dieser Parameter die Anzahl von Datensätzen an, die von der aktuellen Anzahl reservierter Datensätze subtrahiert werden sollen, darf aber niemals die reservierte Anzahl überschreiten.
[in, out] pcbAdjustment
Die Anzahl der Byte des reservierungsspeicherplatzes, der von der Anpassung betroffen ist.
Wenn diese Zahl bei der Eingabe positiv ist, wird die gesamt verbleibende Größe des reservierten Speicherplatzes nach der Anpassung angegeben. Wenn dieser Parameter negativ ist, ist sein absoluter Wert die Anzahl der frei zu gebenden Bytes.
Dieser Wert ist in der Regel ein Aggregat des tatsächlichen reservierten Speicherplatzes, der in einem vorherigen Aufruf von Folgendes zurückgegeben wird:
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Die folgende Liste identifiziert die möglichen Fehlercodes:
Hinweise
Wenn Sie Datensätze reservieren, reservieren Sie eine bestimmte Größe. Wenn Sie diese Datensätze freigeben, müssen Sie die gleiche Größe freigeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | clfsw32.h |
| Bibliothek | Clfsw32.lib |
| DLL | Clfsw32.dll |