Funzione CcSetCacheFileSizes (ntifs.h)
La funzione CcSetCacheFileSizes imposta le dimensioni dei file di gestione cache in base ai puntatori agli oggetti sezione.
Sintassi
NTSTATUS CcSetCacheFileSizes(
[in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] PCC_FILE_SIZES FileSizes
);
Parametri
[in] SectionObjectPointer
Puntatore a una struttura SECTION_OBJECT_POINTERS che contiene 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 è necessaria una ripulitura, l'eliminazione 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 causa CcSetCacheFileSizes scaricare e/o eliminare il file, CcSetCacheFileSizes non genererà errori; restituisce semplicemente il codice NTSTATUS appropriato dell'operazione di scaricamento o eliminazione.
Se l'operazione fa sì che CcSetCacheFileSizes estendere la sezione, CcSetCacheFileSizes genererà un errore durante l'estensione.
Osservazioni
Se l'operazione causa CcSetCacheFileSizes estendere la sezione e si verifica un errore, CcSetCacheFileSizes genera un'eccezione di stato per quel particolare errore. 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 try-except o istruzione try-finally.
Il file system deve assicurarsi che la mappa della cache sia valida e rimanga così per la durata di questa chiamata.
Per ottenere le dimensioni del file memorizzato nella cache, passare SectionObjectPointer a CcGetCacheFileSize.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 11, versione 22H2 |
| intestazione |
ntifs.h |