Función FltQueryQuotaInformationFile (fltkernel.h)

La rutina de 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 necesario y no se puede null.

[in] FileObject

Puntero de objeto de archivo para un archivo abierto, directorio, dispositivo de almacenamiento o volumen. Este parámetro es necesario y no se puede 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 de contendrá la ubicación en sidList donde se produjo el error.

[out] Buffer

Puntero a un búfer de entrada estructurado de FILE_GET_QUOTA_INFORMATION proporcionado por el autor de la llamada donde se van a devolver los valores de información de cuota.

[in] Length

Longitud, en bytes, del búfer al que apunta el Búfer parámetro.

[in] ReturnSingleEntry

Establézcalo en TRUE si fltQueryQuotaInformationFile debe devolver solo la primera entrada que se encuentra.

[in, optional] SidList

Puntero a un FILE_GET_QUOTA_INFORMATIONbúfer de entrada estructurado 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 se puede 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 se puede NULL.

[in] RestartScan

Establézcalo 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 está establecido 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 se puede NULL.

Valor devuelto

fltQueryQuotaInformationFile devuelve STATUS_SUCCESS o un valor NTSTATUS adecuado, como el siguiente.

Requisitos

Consulte también

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile