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 de 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 de que 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 vaciar o purgar el archivo, CcSetCacheFileSizes no se producirán 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 extender la sección, CcSetCacheFileSizes generará cualquier error que se produzca durante esta extensión.
Observaciones
Si la operación hace que CcSetCacheFileSizes extender la sección y se produzca un error, CcSetCacheFileSizesizes 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 un try-except o instrucción 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 | Valor |
|---|---|
| cliente mínimo admitido | Windows 11, versión 22H2 |
| encabezado de |
ntifs.h |