Función CcSetCacheFileSizes (ntifs.h)
La función CcSetCacheFileSizes establece los tamaños de archivo del administrador de caché por punteros de objeto de sección.
Sintaxis
NTSTATUS CcSetCacheFileSizes(
[in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
[in] PCC_FILE_SIZES FileSizes
);
Parámetros
[in] SectionObjectPointer
Puntero a una estructura SECTION_OBJECT_POINTERS que contiene la información del objeto de sección.
[in] FileSizes
Puntero a una estructura de CC_FILE_SIZES que especifica el tamaño de archivo que se va a establecer.
Valor devuelto
CcSetCacheFileSizes devuelve STATUS_SUCCESS si el tamaño del archivo se cambió correctamente y, si se necesitaba una purga, la purga se realizó correctamente. De lo contrario, devuelve un código NSTATUS no correcto, como STATUS_INSUFFICIENT_RESOURCES, y podría generar una excepción de estado.
Con respecto a la generación de una excepción de estado en caso de error:
Si la operación hace que CcSetCacheFileSizes vacíe o purgue el archivo, CcSetCacheFileSizes no generará errores; simplemente devuelve el código NTSTATUS no correcto adecuado de la operación de vaciado o purga.
Si la operación hace que CcSetCacheFileSizes extienda la sección, CcSetCacheFileSizes generará cualquier error que se produzca durante esta extensión.
Comentarios
Si la operación hace que CcSetCacheFileSizes extienda la sección y se produzca un error, CcSetCacheFileSizes genera una excepción de estado para ese error en particular. Por ejemplo, si se produce un error de asignación de grupo, CcSetCacheFileSizes genera una excepción de STATUS_INSUFFICIENT_RESOURCES. Por lo tanto, para obtener control si se produce un error, el controlador debe encapsular la llamada a CcSetCacheFileSizes en una instrucción try-except o try-finally .
El sistema de archivos debe asegurarse de que la asignación de caché es válida y permanecerá así durante la duración de esta llamada.
Para obtener el tamaño del archivo almacenado en caché, pase SectionObjectPointer a CcGetCacheFileSize.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11, versión 22H2 |
| Encabezado | ntifs.h |