Funzione FsRtlQueryInformationFile (ntifs.h)

Articolo
02/29/2024

FsRtlQueryInformationFile compila informazioni esplicite sulle query sui file IRP (IRP_MJ_QUERY_INFORMATION), lo invia nello stack, attende in modo sincrono il completamento e restituisce il risultato. Questa funzione consente al chiamante di completare questa azione da FileObject anziché da handle.

Sintassi

NTSTATUS FsRtlQueryInformationFile(
  [in]  PFILE_OBJECT           FileObject,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass,
  [out] PULONG                 RetFileInformationSize
);

Parametri

[in] FileObject

Puntatore al FILE_OBJECT per inviare l'operazione.

[out] FileInformation

Puntatore a un buffer allocato dal chiamante per ricevere le informazioni sul file sottoposte a query.

[in] Length

Dimensioni in byte del buffer a cui punta FileInformation .

[in] FileInformationClass

Valore FILE_INFORMATION_CLASS che specifica il tipo di informazioni sui file su cui viene eseguito la query.

[out] RetFileInformationSize

Riceve il numero di byte scritti (restituiti) nel buffer a cui punta FileInformation .

Valore restituito

FsRtlKernelFsControlFile restituisce STATUS_SUCCESS o un valore NTSTATUS appropriato, ad esempio uno dei seguenti.

Valore	Significato
STATUS_INSUFFICIENT_RESOURCES	Si è verificato un errore di allocazione del pool.
STATUS_INVALID_PARAMETER	È stato specificato un parametro non valido, ad esempio un FileObject non valido.

Commenti

Questa routine presuppone che tutti i buffer passati siano buffer in modalità kernel.

Requisiti

Requisito	Valore
Intestazione	ntifs.h

Vedi anche

ZwQueryInformationFile

Share via