FILE_FS_ATTRIBUTE_INFORMATION 構造体 (ntifs.h)

FILE_FS_ATTRIBUTE_INFORMATION構造体は、ファイル システムの属性情報を照会するために使用されます。

構文

typedef struct _FILE_FS_ATTRIBUTE_INFORMATION {
  ULONG FileSystemAttributes;
  LONG  MaximumComponentNameLength;
  ULONG FileSystemNameLength;
  WCHAR FileSystemName[1];
} FILE_FS_ATTRIBUTE_INFORMATION, *PFILE_FS_ATTRIBUTE_INFORMATION;

メンバー

FileSystemAttributes

次のフラグの互換性のある組み合わせとして、指定されたファイル システムの属性を指定するフラグのビットマスク。

MaximumComponentNameLength

指定したファイル システムでサポートされるファイル名コンポーネントの最大長 (バイト単位)。 ファイル名コンポーネントは、パス区切り文字 (円記号など) の間のファイル名の部分です。

FileSystemNameLength

ファイル システム名の長さ (バイト単位)。 このフィールドの値は 0 より大きくなければなりません。

FileSystemName[1]

ファイル システムの名前を含む可変長 Unicode フィールド。 このフィールドは null で終わるのではなく、 FileSystemNameLength バイトのシーケンスとして処理する必要があります。

注釈

この情報は、次のいずれかの方法で照会できます。

• FltQueryVolumeInformation または ZwQueryVolumeInformationFile を呼び出し、FileFsAttributeInformationを FileInformationClass の値として渡し、呼び出し元によって割り当てられたFILE_FS_ATTRIBUTE_INFORMATION構造化バッファーを FileInformation の値として渡します。

  • 注: CSVFS では、 FileFsAttributeInformation は CSVFS ファイル システムの FILE_FS_ATTRIBUTE_INFORMATION を返します。 CSVFS がレイヤー化されたファイル システムに対して FileFsAttributeInformation を照会する場合は、 FSCTL_CSV_QUERY_DOWN_LEVEL_FILE_SYSTEM_CHARACTERISTICSを使用する必要があります。

• 主要な関数コード IRP_MJ_QUERY_VOLUME_INFORMATIONを使用して IRP を作成します。

この情報を照会するために特定のアクセス権は必要ありません。 したがって、この情報は、ボリューム自体、またはボリューム上のファイルまたはディレクトリへのオープン ハンドルを介してボリュームにアクセスする限り使用できます。

FileInformation パラメーターで FltQueryVolumeInformation または ZwQueryVolumeInformationFile に渡されるバッファーのサイズは、少なくとも sizeof(FILE_FS_ATTRIBUTE_INFORMATION)である必要があります。 ファイル システム名の最大長は想定できないため (実質的には、制限は 2^31 文字ポイント)、 FileSystemNameLength がわかったら、これらのルーチンの 2 回目の呼び出しが必要になります。

この構造体は 、LONG (4 バイト) 境界に配置する必要があります。

要件

こちらもご覧ください

ACL

FltQueryVolumeInformation

IRP_MJ_QUERY_VOLUME_INFORMATION

ZwQueryVolumeInformationFile