Bagikan melalui

Enumerasi GETPROPERTYSTOREFLAGS (propsys.h)

  • Artikel

Menunjukkan bendera yang memodifikasi objek penyimpanan properti yang diambil oleh metode yang membuat penyimpanan properti, seperti IShellItem2::GetPropertyStore atau IPropertyStoreFactory::GetPropertyStore.

Sintaks

typedef enum GETPROPERTYSTOREFLAGS {
  GPS_DEFAULT = 0,
  GPS_HANDLERPROPERTIESONLY = 0x1,
  GPS_READWRITE = 0x2,
  GPS_TEMPORARY = 0x4,
  GPS_FASTPROPERTIESONLY = 0x8,
  GPS_OPENSLOWITEM = 0x10,
  GPS_DELAYCREATION = 0x20,
  GPS_BESTEFFORT = 0x40,
  GPS_NO_OPLOCK = 0x80,
  GPS_PREFERQUERYPROPERTIES = 0x100,
  GPS_EXTRINSICPROPERTIES = 0x200,
  GPS_EXTRINSICPROPERTIESONLY = 0x400,
  GPS_VOLATILEPROPERTIES = 0x800,
  GPS_VOLATILEPROPERTIESONLY = 0x1000,
  GPS_MASK_VALID = 0x1fff
} ;

Konstanta

 
GPS_DEFAULT
Nilai: 0
Artinya untuk proses panggilan: Mengembalikan penyimpanan properti baca-saja yang berisi semua properti. Item lambat (berkas luring) tidak dibuka.



Kombinasi dengan bendera lain: Dapat ditimpa oleh bendera lain.
GPS_HANDLERPROPERTIESONLY
Nilai: 0x1
Artinya untuk proses panggilan: Hanya sertakan properti langsung dari handler properti, yang membuka file pada disk, jaringan, atau perangkat.



Artinya untuk folder file: Hanya sertakan properti langsung dari handler.

Artinya untuk folder lain: Saat mendelegasikan ke folder file, teruskan bendera ini ke folder file; tidak melakukan multipleks (MUX). Saat tidak mendelegasikan ke folder file, abaikan bendera ini alih-alih mengembalikan kode kegagalan.

Kombinasi dengan bendera lain: Tidak dapat digabungkan dengan GPS_TEMPORARY, GPS_FASTPROPERTIESONLY, atau GPS_BESTEFFORT.
GPS_READWRITE
Nilai: 0x2
Artinya untuk proses panggilan: Dapat menulis properti ke item. Catatan: Penyimpanan mungkin berisi lebih sedikit properti daripada penyimpanan baca-saja.



Artinya untuk folder file: ReadWrite.

Artinya untuk folder lain: ReadWrite. Catatan: Saat menggunakan MUX default, kembalikan penyimpanan tunggal yang tidak diubah karena MUX default tidak mendukung ReadWrite.

Kombinasi dengan bendera lain: Tidak dapat digabungkan dengan GPS_TEMPORARY, GPS_FASTPROPERTIESONLY, GPS_BESTEFFORT, atau GPS_DELAYCREATION. Menyiratkan GPS_HANDLERPROPERTIESONLY.
GPS_TEMPORARY
Nilai: 0x4
Artinya untuk proses panggilan: Menyediakan penyimpanan bisa-tulis, tanpa properti awal, yang ada selama masa pakai instans item Shell; pada dasarnya, tas properti yang melekat pada instans item.



Artinya ke folder file: Tidak berlaku. Ditangani oleh item Shell.

Artinya untuk folder lain: Tidak berlaku. Ditangani oleh item Shell.

Kombinasi dengan bendera lain: Tidak dapat digabungkan dengan bendera lainnya. Menyiratkan GPS_READWRITE.
GPS_FASTPROPERTIESONLY
Nilai: 0x8
Artinya untuk proses panggilan: Menyediakan penyimpanan yang tidak melibatkan pembacaan dari disk atau jaringan. Catatan: Beberapa nilai mungkin berbeda, atau hilang, dibandingkan dengan penyimpanan tanpa bendera ini.



Artinya untuk folder file: Sertakan penyimpanan "bawaan" dan "fallback" saja. Jangan muat handler.

Artinya untuk folder lain: Hanya sertakan properti yang tersedia dalam memori atau dapat dihitung dengan sangat cepat (tidak ada properti dari perangkat IO disk, jaringan, atau periferal). Ini biasanya hanya sumber data dari IDLIST. Saat mendelegasikan ke folder lain, teruskan bendera ini kepada mereka.

Kombinasi dengan bendera lain: Tidak dapat digabungkan dengan GPS_TEMPORARY, GPS_READWRITE, GPS_HANDLERPROPERTIESONLY, atau GPS_DELAYCREATION.
GPS_OPENSLOWITEM
Nilai: 0x10
Artinya untuk proses panggilan: Buka item lambat (file offline) jika perlu.



Artinya ke folder file: Ambil file dari penyimpanan offline, jika perlu. Catatan: Tanpa bendera ini, handler tidak dibuat untuk file offline.

Artinya untuk folder lain: Jangan kembalikan properti apa pun yang sangat lambat.

Kombinasi dengan bendera lain: Tidak dapat digabungkan dengan GPS_TEMPORARY atau GPS_FASTPROPERTIESONLY.
GPS_DELAYCREATION
Nilai: 0x20
Artinya untuk proses panggilan: Tunda operasi intensif memori, seperti akses file, hingga properti diminta yang memerlukan akses tersebut.



Artinya untuk folder file: Jangan membuat handler sampai diperlukan; misalnya, GetCount/GetAt atau GetValue, di mana toko bawaan tidak memenuhi permintaan. Catatan: GetValue mungkin gagal karena masalah akses file.

Artinya folder lain: Jika folder memiliki properti intensif memori, seperti mendelegasikan ke folder file atau akses jaringan, folder tersebut dapat mengoptimalkan performa dengan mendukung IDelayedPropertyStoreFactory dan membagi propertinya menjadi penyimpanan yang cepat dan lambat. Kemudian dapat menggunakan MUX yang tertunda untuk menyusunnya kembali.

Kombinasi dengan bendera lain: Tidak dapat digabungkan dengan GPS_TEMPORARY atau GPS_READWRITE.
GPS_BESTEFFORT
Nilai: 0x40
Artinya untuk proses panggilan: Berhasil mendapatkan toko, bahkan jika beberapa properti tidak dikembalikan. Catatan: Beberapa nilai mungkin berbeda, atau hilang, dibandingkan dengan penyimpanan tanpa bendera ini.



Artinya folder file: Berhasil dan kembalikan penyimpanan, meskipun handler atau penyimpanan bawaan memiliki kesalahan selama pembuatan. Hanya gagal jika substore gagal.

Artinya folder lain: Berhasil mendapatkan penyimpanan, bahkan jika beberapa properti tidak dikembalikan.

Kombinasi dengan bendera lain: Tidak dapat digabungkan dengan GPS_TEMPORARY, GPS_READWRITE, atau GPS_HANDLERPROPERTIESONLY.
GPS_NO_OPLOCK
Nilai: 0x80
Windows 7 dan yang lebih baru. Penelepon harus menggunakan bendera ini hanya jika mereka sudah memegang kunci oportunistik (oplock) pada file karena tanpa oplock, operasi ikatan tidak dapat dilanjutkan. Secara default, Shell meminta oplock pada file sebelum mengikat ke handler properti. Bendera ini menonaktifkan perilaku default.

Windows Server 2008 dan Windows Vista: Bendera ini tidak tersedia.
GPS_PREFERQUERYPROPERTIES
Nilai: 0x100
Windows 8 dan yang lebih baru. Gunakan bendera ini untuk hanya mengambil properti dari pengindeks untuk hasil WDS.
GPS_EXTRINSICPROPERTIES
Nilai: 0x200
Sertakan properti dari aliran sekunder file.
GPS_EXTRINSICPROPERTIESONLY
Nilai: 0x400
Sertakan hanya properti dari aliran sekunder file.
GPS_VOLATILEPROPERTIES
Nilai: 0x800
GPS_VOLATILEPROPERTIESONLY
Nilai: 0x1000
GPS_MASK_VALID
Nilai: 0x1fff
Masker untuk nilai GETPROPERTYSTOREFLAGS yang valid.

Keterangan

Jika item Shell adalah file, penyimpanan properti berisi item berikut.

  • Properti dari sistem file yang menyangkut file.
  • Properti dari file itu sendiri yang disediakan oleh handler properti file, kecuali file offline (lihat GPS_OPENSLOWITEM).
Item Shell non-file mengembalikan penyimpanan baca-saja yang serupa.
Catatan GPS_INCLUDEOFFLINEPROPERTIES telah digantikan oleh GPS_OPENSLOWITEM.
 

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header propsys.h