FsRtlQueryInformationFile 函式 (ntifs.h)
FsRtlQueryInformationFile 建置明確的檔案查詢資訊 IRP (IRP_MJ_QUERY_INFORMATION),將它傳送到堆棧,以同步方式等候它完成,並傳回結果。 此函式可讓呼叫者 FileObject 來完成此動作,而不是句柄。
語法
NTSTATUS FsRtlQueryInformationFile(
[in] PFILE_OBJECT FileObject,
[out] PVOID FileInformation,
[in] ULONG Length,
[in] FILE_INFORMATION_CLASS FileInformationClass,
[out] PULONG RetFileInformationSize
);
參數
[in] FileObject
要傳送作業之 FILE_OBJECT 的指標。
[out] FileInformation
呼叫端配置的緩衝區指標,以接收查詢的檔案資訊。
[in] Length
FileInformation 指向的緩衝區位元組大小。
[in] FileInformationClass
FILE_INFORMATION_CLASS 值,指定要查詢的檔案信息類型。
[out] RetFileInformationSize
接收寫入的位元組數(傳回)到 FileInformation 指向的緩衝區。
傳回值
FsRtlKernelFsControlFile 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值,例如下列其中一項。
價值 | 意義 |
---|---|
STATUS_INSUFFICIENT_RESOURCES | 發生集區配置失敗。 |
STATUS_INVALID_PARAMETER | 提供了無效的參數(例如,無效 FileObject)。 |
言論
此例程假設所有傳入的緩衝區都是核心模式緩衝區。
要求
要求 | 價值 |
---|---|
標頭 | ntifs.h |