struktur FILE_OBJECTID_INFORMATION (ntifs.h)
Struktur FILE_OBJECTID_INFORMATION digunakan untuk mengkueri informasi ID objek untuk file dalam direktori pada volume NTFS.
Sintaks
typedef struct _FILE_OBJECTID_INFORMATION {
LONGLONG FileReference;
UCHAR ObjectId[16];
union {
struct {
UCHAR BirthVolumeId[16];
UCHAR BirthObjectId[16];
UCHAR DomainId[16];
} DUMMYSTRUCTNAME;
UCHAR ExtendedInfo[48];
} DUMMYUNIONNAME;
} FILE_OBJECTID_INFORMATION, *PFILE_OBJECTID_INFORMATION;
Anggota
FileReference
Nomor referensi file 8-byte untuk file. NTFS menghasilkan angka ini dan menetapkannya ke file secara otomatis ketika file dibuat.
ObjectId[16]
ID objek file 16-byte untuk file tersebut. NTFS menghasilkan nomor ini dan menetapkannya ke file atas permintaan driver atau aplikasi. ID objek file dijamin unik hanya dalam volume tempat file berada.
DUMMYUNIONNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME.BirthVolumeId[16]
Pengidentifikasi objek volume tempat file berada ketika pengidentifikasi objek dibuat, atau nol jika volume tidak memiliki pengidentifikasi objek pada saat itu. Setelah operasi salin, operasi pemindahan, atau operasi file lainnya, BirthVolumeId mungkin tidak sama dengan pengidentifikasi objek volume tempat objek saat ini berada.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.BirthObjectId[16]
Pengidentifikasi objek file pada saat dibuat. Setelah operasi salin, operasi pemindahan, atau operasi file lainnya BirthObjectId mungkin tidak sama dengan nilai anggota ObjectId saat ini.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.DomainId[16]
Dipesan; harus nol.
DUMMYUNIONNAME.ExtendedInfo[48]
Data yang disediakan pengguna. Anda dapat menggunakannya untuk berisi anggota BirthVolumeID, BirthObjectID, dan DomainID , atau Anda dapat menentukan struktur data yang berbeda.
Keterangan
Informasi ini dapat dikueri dengan salah satu cara berikut:
Panggil ZwQueryDirectoryFile, meneruskan FileObjectIdInformation sebagai nilai FileInformationClass dan meneruskan buffer yang dialokasikan pemanggil, FILE_OBJECTID_INFORMATION terstruktur sebagai nilai FileInformation.
Buat IRP dengan kode fungsi utama IRP_MJ_DIRECTORY_CONTROL dan kode fungsi minor IRP_MN_QUERY_DIRECTORY.
Tidak ada hak akses khusus yang diperlukan untuk mengkueri informasi ini.
Dukungan untuk nomor referensi file dan ID objek file adalah spesifik sistem file:
- ID objek file hanya didukung pada volume NTFS. NTFS memungkinkan file dibuka dengan ID objek serta dengan nomor referensi file.
- ReFS tidak mendukung ID objek. ReFS menggunakan ID file 128-bit, sehingga tidak dapat membedakan dengan bersih antara ID file versus ID objek saat memproses buka dengan ID. (ID file adalah 64-bit pada NTFS, jadi mudah dibedakan dari ID objek. NTFS juga secara bersamaan mendukung pembukaan dengan ID 128-bit: jika 64-bit tinggi adalah nol, 64-bit rendah diperlakukan sebagai ID file; jika tidak, nilai 128-bit diperlakukan sebagai ID objek.)
Driver filter sistem file yang menggunakan ID objek file harus diuji untuk interoperabilitas dengan DFS, layanan Replicator, dan layanan Pelacakan Tautan Terdistribusi, yang semuanya menggunakan dan memanipulasi ID objek file.
Struktur ini harus diselaraskan pada batas LONG (4-byte).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 |
| Header | ntifs.h (termasuk Ntifs.h, Fltkernel.h) |