Funzione FsRtlQueryInformationFile (ntifs.h)
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 |