Implementasi sistem file IPropertyStorage-NTFS

NTFS versi 5.0 menyediakan implementasi antarmuka IPropertyStorage untuk file pada volume NTFS ketika file bukan file majemuk.

Untuk mendapatkan penunjuk ke implementasi sistem file NTFS dari IPropertySetStorage

  1. Panggil IPropertySetStorage::Create menggunakan implementasi NTFS IPropertySetStorage.
  2. Panggil IPropertySetStorage::Open menggunakan implementasi NTFS IPropertySetStorage.

Kapan Digunakan

Gunakan IPropertyStorage untuk mengelola properti dalam satu set properti. Metodenya mendukung membaca, menulis, dan menghapus properti dan nama string opsional yang dapat dikaitkan dengan pengidentifikasi properti. Metode lain memungkinkan Anda mengatur waktu yang terkait dengan penyimpanan properti, dan metode lain mengizinkan penetapan CLSID, yang digunakan untuk mengaitkan kode lain, seperti kode antarmuka pengguna (UI), dengan kumpulan properti. Memanggil metode Enum memasok pointer ke implementasi NTFS IEnumSTATPROPSTG, yang memungkinkan Anda menghitung properti dalam set.

Keterangan

Implementasi NTFS pada dasarnya menyediakan fitur yang sama dengan implementasi file gabungan. Untuk informasi selengkapnya, lihat Implementasi File IPropertyStorage-Compound.

Karena NTFS adalah sistem file yang kuat, kumpulan properti NTFS tidak akan pernah dibiarkan dalam keadaan salah. Ketika konten NTFS IPropertyStorage disiram ke file NTFS yang mendasarinya, baik semua atau tidak ada status yang ditulis ke file sebagai operasi atomik, bahkan jika ada kegagalan selama operasi seperti penghentian proses abnormal. Untuk mencapai perilaku serupa dengan implementasi file majemuk, antarmuka IPropertySetStorage induk harus dibuka dalam mode bertransaksi.

Tingkat ketahanan ini hanya dimungkinkan saat mengakses properti NTFS yang diatur pada volume NTFS 5.0. Dimungkinkan untuk mengakses set properti NTFS pada versi NTFS yang lebih lama (misalnya, komputer yang berjalan di Windows NT atau Windows 2000 yang mengakses kumpulan properti pada komputer server file yang berjalan di Windows NT 4.0), tetapi mereka tidak dijamin berada dalam keadaan yang benar jika terjadi kegagalan yang tidak terduga.

Meskipun implementasi NTFS IPropertySetStorage tidak mendukung transaksi, implementasi NTFS IPropertyStorage mendukungnya. Artinya, STGM_TRANSACTED dapat ditentukan dalam parameter grfMode ke metode Buat dan BukaIPropertySetStorage. Seperti dalam implementasi file majemuk, mode yang ditransaksikan hanya dimungkinkan untuk penyimpanan properti nonsimple (menentukan PROPSETFLAG_NONSIMPLE dalam parameter grfFlags ).

IPropertyStorage

Implementasi Sistem File IPropertySetStorage-NTFS