ntQueryInformationByName 函式 (ntifs.h)

發行項
02/26/2024

NtQueryInformationByName 會傳回檔名所指定檔案的要求資訊。

語法

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationByName(
  [in]  POBJECT_ATTRIBUTES     ObjectAttributes,
  [out] PIO_STATUS_BLOCK       IoStatusBlock,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

參數

[in] ObjectAttributes

包含檔案屬性的OBJECT_ATTRIBUTES 結構的指標，包括檔名。

[out] IoStatusBlock

指標包含呼叫端 I/O 狀態的 IO_STATUS_BLOCK 結構。

[out] FileInformation

呼叫端提供的緩衝區指標，用來傳回檔案的要求資訊。緩衝區的結構取決於 FileInformationClass 參數。

[in] Length

FileInformation 所指向緩衝區的長度，以位元組為單位。

[in] FileInformationClass

FILE_INFORMATION_CLASS值，識別 FileInformation 指向之緩衝區中要傳回的文件類型。 FileInformationClass 可以是下列其中一個值。

FILE_INFORMATION_CLASS值	要傳回的信息類型
FileStatInformation (68)	FILE_STAT_INFORMATION。從 Windows 10 1709 版開始提供。
FileStatLxInformation (70)	FILE_STAT_LX_INFORMATION。從 Windows 10 2018 年 4 月更新開始提供。
FileCaseSensitiveInformation (71)	FILE_CASE_SENSITIVE_INFORMATION。從 Windows 10 2018 年 4 月更新開始提供。
FileStatBasicInformation (77)	FILE_STAT_BASIC_INFORMATION。從 Windows 11 組建 26048 開始提供。

傳回值

NtQueryInformationByName 會在成功完成時傳回STATUS_SUCCESS;否則會傳回錯誤碼，例如下列其中一項。

錯誤碼	意義
STATUS_INVALID_PARAMETER	FileInformationClass 參數包含無效的值。
STATUS_INFO_LENGTH_MISMATCH	Length 指定的緩衝區大小不夠大，無法包含要求的資訊。