Funzione FsRtlQueryInformationFile (ntifs.h)
FsRtlQueryInformationFile compila un IRP (IRP_MJ_QUERY_INFORMATION) di query di file esplicito, lo invia nello stack, attende in modo sincrono il completamento e restituisce il risultato. Questa funzione consente al chiamante di completare questa azione FileObject anziché 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 sottoposto 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 fileInformation punta.
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). |
Osservazioni
Questa routine presuppone che tutti i buffer passati siano buffer in modalità kernel.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione |
ntifs.h |