CcSetCacheFileSizes-Funktion (ntifs.h)

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

Syntax

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

Parameter

[in] SectionObjectPointer

Zeigen Sie auf eine SECTION_OBJECT_POINTERS Struktur, die die Abschnittsobjektinformationen enthält.

[in] FileSizes

Zeigen Sie 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 wird ein nicht erfolgreicher NSTATUS-Code wie STATUS_INSUFFICIENT_RESOURCES zurückgegeben und kann eine Status ausnahme auslösen.

Bezüglich des Auslösens einer Status-Ausnahme beim Fehler:

• Wenn der Vorgang bewirkt, dass CcSetCacheFileSizes die Datei geleert und/oder löscht, CcSetCacheFileSizes keine Fehler auslösen; es gibt nur den entsprechenden nicht erfolgreichen NTSTATUS-Code des Lösch- oder Löschvorgangs zurück.

• Wenn der Vorgang bewirkt, dass CcSetCacheFileSizes den Abschnitt erweitern soll, löst CcSetCacheFileSizes bei einem Fehler aus, der während dieser Erweiterung erreicht wird.

Bemerkungen

Wenn der Vorgang bewirkt, dass CcSetCacheFileSizes den Abschnitt erweitern 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. Um die Kontrolle zu erlangen, wenn ein Fehler auftritt, sollte der Treiber den Aufruf von CcSetCacheFileSizes in einem try-except oder try-finally Anweisung umschließen.

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

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

Anforderungen

Siehe auch

CcGetCacheFileSize-

CcSetFileSizesEx-