Funzione CcSetCacheFileSizes (ntifs.h)

  • Articolo

La funzione CcSetCacheFileSizes imposta le dimensioni dei file di gestione cache in base ai puntatori a oggetti della sezione.

Sintassi

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

Parametri

[in] SectionObjectPointer

Puntatore a una struttura SECTION_OBJECT_POINTERS contenente le informazioni sull'oggetto sezione.

[in] FileSizes

Puntatore a una struttura CC_FILE_SIZES che specifica le dimensioni del file da impostare.

Valore restituito

CcSetCacheFileSizes restituisce STATUS_SUCCESS se le dimensioni del file sono state modificate correttamente e, se è stato necessario un'eliminazione che ha avuto esito positivo. In caso contrario, restituisce un codice NSTATUS non riuscito, ad esempio STATUS_INSUFFICIENT_RESOURCES, e potrebbe generare un'eccezione di stato.

Per quanto riguarda la generazione di un'eccezione di stato in caso di errore:

  • Se l'operazione fa sì che CcSetCacheFileSizes scarica e/o elimina il file, CcSetCacheFileSizes non genera errori; restituisce solo il codice NTSTATUS appropriato dell'operazione di scaricamento o eliminazione.

  • Se l'operazione causa l'estensione della sezione CcSetCacheFileSizes , CcSetCacheFileSizes genererà qualsiasi errore durante questa estensione.

Commenti

Se l'operazione causa l'estensione della sezione CcSetCacheFileSizes e si verifica un errore, CcSetCacheFileSizes genera un'eccezione di stato per tale errore specifico. Ad esempio, se si verifica un errore di allocazione del pool, CcSetCacheFileSizes genera un'eccezione STATUS_INSUFFICIENT_RESOURCES. Pertanto, per ottenere il controllo se si verifica un errore, il driver deve eseguire il wrapping della chiamata a CcSetCacheFileSizes in un'istruzione try-except o try-finally .

Il file system deve assicurarsi che la mappa della cache sia valida e rimanga per la durata di questa chiamata.

Per ottenere le dimensioni del file memorizzato nella cache, passare SectionObjectPointer a CcGetCacheFileSize.

Requisiti

Requisito Valore
Client minimo supportato Windows 11, versione 22H2
Intestazione ntifs.h

Vedi anche

CcGetCacheFileSize

CcSetFileSizesEx