FILE_FS_OBJECTID_INFORMATION 構造体 (ntddk.h)

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

FILE_FS_OBJECTID_INFORMATION構造体は、ファイルシステムボリュームのオブジェクト ID を照会または設定するために使用されます。

構文

typedef struct _FILE_FS_OBJECTID_INFORMATION {
  UCHAR ObjectId[16];
  UCHAR ExtendedInfo[48];
} FILE_FS_OBJECTID_INFORMATION, *PFILE_FS_OBJECTID_INFORMATION;

メンバー

ObjectId[16]

ディスク上のファイルシステムボリュームを識別する 16 バイト GUID。

ExtendedInfo[48]

ファイルシステムボリュームに関する追加の呼び出し元定義情報を含む 48 バイトの値。この拡張情報の意味は、ファイルシステムに対して不透明です。

注釈

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

FltQueryVolumeInformation または ZwQueryVolumeInformationFile を呼び出し、FileFsObjectIdInformation を FileInformationClass の値として渡し、呼び出し元によって割り当てられたFILE_FS_OBJECTID_INFORMATION構造化バッファーを FileInformation の値として渡します。
主要な関数コード IRP_MJ_QUERY_VOLUME_INFORMATIONを使用して IRP を作成します。

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

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

FltSetVolumeInformation または ZwSetVolumeInformationFile を呼び出し、FileFsObjectIdInformation を FileInformationClass の値として渡し、呼び出し元によって割り当てられたFILE_FS_OBJECTID_INFORMATION構造化バッファーを FileInformation の値として渡します。
主要な関数コード IRP_MJ_SET_VOLUME_INFORMATIONを使用して IRP を作成します。

この情報FILE_WRITE_DATA設定するには、ボリュームへのアクセスが必要です。

ボリュームオブジェクト ID のサポートは、ファイルシステム固有です。 NTFS では、ボリュームオブジェクト ID は分散リンク追跡サービスによって広範囲に使用されます。

ボリュームオブジェクト ID はボリューム GUID と同じではないことに注意してください。 ボリュームオブジェクト ID は、ファイルシステムによってファイルシステムボリュームに割り当てられます。 ボリューム GUID または一意のボリューム名は、ファイルシステムに依存しません。ボリュームマウントマネージャーによって基になるストレージボリュームに割り当てられます。

ボリュームのボリューム GUID を取得するには、Win32 GetVolumeNameForVolumeMountPointW 関数または FltGetVolumeGuidName ルーチンを使用します。

FileInformation パラメーターで FltQueryVolumeInformation、FltSetVolumeInformation、ZwQueryVolumeInformationFile、または ZwSetVolumeInformationFile に渡されるバッファーのサイズは、少なくとも sizeof (FILE_FS_OBJECTID_INFORMATION) である必要があります。

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