Función FltQueryQuotaInformationFile (fltkernel.h)
La rutina FltQueryQuotaInformationFile recupera las entradas de cuota asociadas a un objeto de archivo.
Sintaxis
NTSTATUS FLTAPI FltQueryQuotaInformationFile(
[in] PFLT_INSTANCE Instance,
[in] PFILE_OBJECT FileObject,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID Buffer,
[in] ULONG Length,
[in] BOOLEAN ReturnSingleEntry,
[in, optional] PVOID SidList,
[in] ULONG SidListLength,
[in, optional] PULONG StartSid,
[in] BOOLEAN RestartScan,
[out, optional] PULONG LengthReturned
);
Parámetros
[in] Instance
Puntero de instancia opaco para el autor de la llamada. Este parámetro es obligatorio y no puede ser NULL.
[in] FileObject
Puntero de objeto de archivo para un archivo abierto, un directorio, un dispositivo de almacenamiento o un volumen. Este parámetro es obligatorio y no puede ser NULL.
[out] IoStatusBlock
Un IO_STATUS_BLOCK proporcionado por el autor de la llamada para recibir el resultado de la llamada a FltQueryQuotaInformationFile. Si se produce un error en la llamada debido a una lista de SID no válida, el campo Información contendrá la ubicación en SidList donde se produjo el error.
[out] Buffer
Puntero a un búfer de entrada estructurado FILE_GET_QUOTA_INFORMATION proporcionado por el autor de la llamada donde se devolverán los valores de información de cuota.
[in] Length
Longitud, en bytes, del búfer al que apunta el parámetro Buffer .
[in] ReturnSingleEntry
Se establece en TRUE si FltQueryQuotaInformationFile debe devolver solo la primera entrada que se encuentra.
[in, optional] SidList
Puntero a un búfer de entrada estructurado FILE_GET_QUOTA_INFORMATION proporcionado por el autor de la llamada que especifica la información de cuota que se va a consultar. Este parámetro es opcional y puede ser NULL.
[in] SidListLength
Longitud, en bytes, del búfer al que apunta el parámetro SidList .
[in, optional] StartSid
Índice de la entrada en la que se va a comenzar a examinar la lista de información de cuota del archivo. Este parámetro se omite si el parámetro SidList apunta a una lista no vacía. Este parámetro es opcional y puede ser NULL.
[in] RestartScan
Se establece en TRUE si FltQueryQuotaInformationFile debe comenzar el examen en la primera entrada de la lista de información de cuota del archivo. Si este parámetro no se establece en TRUE, el examen se reanuda desde una llamada anterior a FltQueryQuotaInformationFile.
[out, optional] LengthReturned
Puntero a una variable asignada por el autor de la llamada que recibe el tamaño, en bytes, de la información devuelta en Buffer. Este parámetro es opcional y puede ser NULL.
Valor devuelto
FltQueryQuotaInformationFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente.
| Código devuelto | Descripción |
|---|---|
|
La instancia o el volumen se están descomponiéndose. Se trata de un código de error. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 8. |
| Plataforma de destino | Universal |
| Encabezado | fltkernel.h (incluya Fltkernel.h) |
| Library | FltMgr.lib |
| Archivo DLL | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |