ZwQueryInformationByName 関数 (wdm.h)

[アーティクル]
08/08/2023

ZwQueryInformationByName は、ファイル名で指定されたファイルに関する要求された情報を返します。

構文

NTSYSAPI NTSTATUS ZwQueryInformationByName(
  [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

FileInformation が指すバッファーで返すファイル情報の種類を識別するFILE_INFORMATION_CLASS値。 FileInformationClass には、次のいずれかの値を指定できます。

FILE_INFORMATION_CLASS値	返す情報の種類
FileStatInformation (68)	FILE_STAT_INFORMATION。 Windows 10 バージョン 1709 以降で使用できます。
FileStatLxInformation (70)	FILE_STAT_LX_INFORMATION。 2018 年 4 月の更新プログラムWindows 10以降で使用できます。
FileCaseSensitiveInformation (71)	FILE_CASE_SENSITIVE_INFORMATION。 2018 年 4 月の更新プログラムWindows 10以降で使用できます。

戻り値

ZwQueryInformationByName は、正常に完了するとSTATUS_SUCCESSを返します。それ以外の場合は、次のいずれかのエラーコードが返されます。

エラーコード	意味
STATUS_INVALID_PARAMETER	FileInformationClass パラメーターに無効な値が含まれています。
STATUS_INFO_LENGTH_MISMATCH	Length で指定されたバッファーサイズは、要求された情報を格納するのに十分な大きさではありません。