CcPurgeCacheSection-Funktion (ntifs.h)

Artikel
12/21/2024

Die CcPurgeCacheSection Routine löscht alle oder einen Teil einer zwischengespeicherten Datei aus dem Systemcache.

Syntax

BOOLEAN CcPurgeCacheSection(
  [in]           PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in, optional] PLARGE_INTEGER           FileOffset,
  [in]           ULONG                    Length,
                 ULONG                    Flags
);

Parameter

[in] SectionObjectPointer

Zeigen Sie auf eine Struktur, die die Abschnittsobjektzeiger des Dateiobjekts enthält.

[in, optional] FileOffset

Zeigen Sie auf eine Variable, die den Anfangsbyte-Offset in der zwischengespeicherten Datei angibt, in der die Daten gelöscht werden sollen.

Wenn FileOffset-NULL-ist, wird die gesamte Datei aus dem Cache gelöscht.

Wenn FileOffset- nicht NULL-ist, wird nur der durch FileOffset- angegebene Bytebereich und Length gelöscht.

[in] Length

Länge des zu löschenden Bytebereichs ab FileOffset-. Wenn Length null ist, wird der Bereich von FileOffset- bis zum Ende der Datei gelöscht. Wenn FileOffset-NULL-ist, wird Länge ignoriert.

Flags

Legen Sie diesen Wert auf TRUE fest, alle privaten Cachezuordnungen für die Datei aufzuheben, bevor Sie die Dateidaten löschen.

Rückgabewert

CcPurgeCacheSection- gibt TRUE- zurück, wenn die zwischengespeicherten Dateidaten erfolgreich gelöscht wurden, andernfalls FALSE.

Bemerkungen

Dateisysteme rufen CcPurgeCacheSection auf, um veraltete Daten aus dem Cache zu löschen. Wenn z. B. eine Datei abgeschnitten, aber nicht gelöscht wird, sollte CcPurgeCacheSection- aufgerufen werden, um alle zwischengespeicherten Daten zu löschen, die nicht mehr Teil der Datei sind.

"CcPurgeCacheSection"- werden zugeordnete Dateien nicht gelöscht.

Vor dem Aufrufen CcPurgeCacheSectionmuss der Aufrufer die Datei exklusiv abrufen und sicherstellen, dass kein Thread, einschließlich des Aufrufers, einen Bytebereich in der Datei zugeordnet oder angeheftet hat.