CcSetCacheFileSizes-Funktion (ntifs.h)

Die CcSetCacheFileSizes-Funktion legt die Cache-Manager-Dateigrößen nach Abschnittsobjektzeigern fest.

Syntax

NTSTATUS CcSetCacheFileSizes(
  [in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in] PCC_FILE_SIZES           FileSizes
);

Parameter

[in] SectionObjectPointer

Zeiger auf eine SECTION_OBJECT_POINTERS-Struktur , die die Abschnittsobjektinformationen enthält.

[in] FileSizes

Zeiger auf eine CC_FILE_SIZES-Struktur , die die festzulegende Dateigröße angibt.

Rückgabewert

CcSetCacheFileSizes gibt STATUS_SUCCESS zurück, wenn die Dateigröße erfolgreich geändert wurde, und, wenn eine Bereinigung erforderlich war, dass die Bereinigung erfolgreich war. Andernfalls gibt er einen nicht erfolgreichen NSTATUS-Code wie STATUS_INSUFFICIENT_RESOURCES zurück und löst möglicherweise eine status Ausnahme aus.

In Bezug auf das Auslösen einer status Ausnahme bei Fehler:

• Wenn der Vorgang bewirkt, dass CcSetCacheFileSizes die Datei leert und/oder löscht, löst CcSetCacheFileSizes keine Fehler aus. Es gibt nur den entsprechenden NICHT erfolgreichen NTSTATUS-Code des Leerungs- oder Bereinigungsvorgangs zurück.

• Wenn der Vorgang bewirkt, dass CcSetCacheFileSizes den Abschnitt erweitert, löst CcSetCacheFileSizes bei jedem Fehler aus, der während dieser Erweiterung auftritt.

Hinweise

Wenn der Vorgang bewirkt, dass CcSetCacheFileSizes den Abschnitt erweitert und ein Fehler auftritt, löst CcSetCacheFileSizes eine status Ausnahme für diesen bestimmten Fehler aus. Wenn beispielsweise ein Poolzuordnungsfehler auftritt, löst CcSetCacheFileSizes eine STATUS_INSUFFICIENT_RESOURCES Ausnahme aus. Daher sollte der Treiber den Aufruf von CcSetCacheFileSizes in eine try-except- oder try-finally-Anweisung umschließen, um kontrolle zu erhalten, wenn ein Fehler auftritt.

Das Dateisystem muss sicherstellen, dass die Cachezuordnung gültig ist und für die Dauer dieses Aufrufs beibehalten wird.

Um die Größe der zwischengespeicherten Datei abzurufen, übergeben Sie SectionObjectPointer an CcGetCacheFileSize.

Anforderungen

Weitere Informationen

CcGetCacheFileSize

CcSetFileSizesEx