struktur FILE_FS_OBJECTID_INFORMATION (ntddk.h)

Artikel
08/07/2023

Struktur FILE_FS_OBJECTID_INFORMATION digunakan untuk mengkueri atau mengatur ID objek untuk volume sistem file.

Sintaks

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

Anggota

ObjectId[16]

GUID 16 byte yang mengidentifikasi volume sistem file pada disk.

ExtendedInfo[48]

Nilai 48 byte yang berisi informasi opsional yang ditentukan penelepon tambahan pada volume sistem file. Arti dari informasi yang diperluas ini buram untuk sistem file.

Keterangan

Informasi ini dapat dikueri dengan salah satu cara berikut:

Panggil FltQueryVolumeInformation atau ZwQueryVolumeInformationFile, meneruskan FileFsObjectIdInformation sebagai nilai FileInformationClass dan melewati buffer yang dialokasikan pemanggil, FILE_FS_OBJECTID_INFORMATION-terstruktur sebagai nilai FileInformation.
Buat IRP dengan kode fungsi utama IRP_MJ_QUERY_VOLUME_INFORMATION.

Tidak diperlukan hak akses khusus untuk mengkueri informasi ini. Dengan demikian informasi ini tersedia selama volume diakses melalui handel terbuka ke volume itu sendiri, atau ke file atau direktori pada volume.

Informasi ini dapat diatur dengan salah satu cara berikut:

Panggil FltSetVolumeInformation atau ZwSetVolumeInformationFile, meneruskan FileFsObjectIdInformation sebagai nilai FileInformationClass dan meneruskan buffer yang dialokasikan pemanggil, FILE_FS_OBJECTID_INFORMATION-terstruktur sebagai nilai FileInformation.
Buat IRP dengan kode fungsi utama IRP_MJ_SET_VOLUME_INFORMATION.

FILE_WRITE_DATA akses ke volume diperlukan untuk mengatur informasi ini.

Dukungan untuk ID objek volume khusus sistem file. Di NTFS, ID objek volume digunakan secara ekstensif oleh layanan pelacakan tautan terdistribusi.

Penting untuk dicatat bahwa ID objek volume tidak sama dengan GUID volume. ID objek volume ditetapkan ke volume sistem file oleh sistem file. GUID volume, atau nama volume unik, tidak bergantung pada sistem file; ini ditetapkan ke volume penyimpanan yang mendasar oleh Volume Mount Manager.

Untuk mendapatkan VOLUME GUID untuk volume, gunakan fungsi Win32 GetVolumeNameForVolumeMountPointW atau rutinitas FltGetVolumeGuidName .

Ukuran buffer yang diteruskan dalam parameter FileInformation ke FltQueryVolumeInformation, FltSetVolumeInformation, ZwQueryVolumeInformationFile, atau ZwSetVolumeInformationFile harus setidaknya sizeof (FILE_FS_OBJECTID_INFORMATION).

Struktur ini harus diselaraskan pada batas LONGLONG (8-byte).