Funzione FltQueryQuotaInformationFile (fltkernel.h)

  • Articolo

La routine FltQueryQuotaInformationFile recupera le voci di quota associate a un oggetto file.

Sintassi

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
);

Parametri

[in] Instance

Puntatore opaco dell'istanza per il chiamante. Questo parametro è obbligatorio e non può essere NULL.

[in] FileObject

Puntatore a oggetti file per un file aperto, directory, dispositivo di archiviazione o volume. Questo parametro è obbligatorio e non può essere NULL.

[out] IoStatusBlock

Un chiamante fornito IO_STATUS_BLOCK per ricevere il risultato della chiamata a FltQueryQuotaInformationFile. Se la chiamata ha esito negativo a causa di un elenco SID non valido, il campo Informazioni conterrà il percorso in SidList in cui si è verificato l'errore.

[out] Buffer

Puntatore a un caller fornito FILE_GET_QUOTA_INFORMATION buffer di input strutturato in cui devono essere restituiti i valori delle informazioni sulle quote.

[in] Length

Lunghezza, in byte, del buffer a cui punta il parametro Buffer .

[in] ReturnSingleEntry

Impostare su TRUE se FltQueryQuotaInformationFile deve restituire solo la prima voce trovata.

[in, optional] SidList

Puntatore a un buffer di input FILE_GET_QUOTA_INFORMATION strutturato fornito dal chiamante che specifica le informazioni sulla quota da eseguire. Questo parametro è facoltativo e può essere NULL.

[in] SidListLength

Lunghezza, in byte, del buffer a cui punta il parametro SidList .

[in, optional] StartSid

Indice della voce in corrispondenza del quale iniziare a analizzare l'elenco delle informazioni sulla quota del file. Questo parametro viene ignorato se il parametro SidList punta a un elenco non interrotto. Questo parametro è facoltativo e può essere NULL.

[in] RestartScan

Impostare su TRUE se FltQueryQuotaInformationFile deve iniziare l'analisi alla prima voce nell'elenco delle informazioni sulle quote del file. Se questo parametro non è impostato su TRUE, l'analisi viene ripresa da una chiamata precedente a FltQueryQuotaInformationFile.

[out, optional] LengthReturned

Puntatore a una variabile allocata dal chiamante che riceve le dimensioni, in byte, delle informazioni restituite nel buffer. Questo parametro è facoltativo e può essere NULL.

Valore restituito

FltQueryQuotaInformationFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio il seguente.

Codice restituito Descrizione
STATUS_FLT_DELETING_OBJECT
 L'istanza o il volume viene eliminato. Si tratta di un codice di errore.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8.
Piattaforma di destinazione Universale
Intestazione fltkernel.h (includere Fltkernel.h)
Libreria FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

Vedi anche

FILE_GET_QUOTA_INFORMATION

FltSetQuotaInformationFile

ZwQueryQuotaInformationFile