Bagikan melalui

SFGAO

  • Artikel

SFGAO nilai bitfield mewakili atribut yang dapat diambil pada item (file atau folder) atau set item. Mereka digunakan dengan API IShellFolder dan IShellItem, terutama IShellFolder::GetAttributesOf dan IShellItem::GetAttributes.

Konstanta/nilai Deskripsi
SFGAO_CANCOPY
0x00000001
 Item yang ditentukan dapat disalin.
SFGAO_CANMOVE
0x00000002
 Item yang ditentukan dapat dipindahkan.
SFGAO_CANLINK
0x00000004
 Pintasan dapat dibuat untuk item yang ditentukan. Atribut ini memiliki nilai yang sama dengan DROPEFFECT_LINK.
Jika ekstensi namespace mengembalikan atribut ini, entri Buat Pintasan dengan handler default ditambahkan ke menu pintasan yang ditampilkan selama operasi seret dan letakkan. Ekstensi juga dapat mengimplementasikan handler sendiri untuk kata kerja tautan sebagai pengganti default. Jika ekstensi melakukannya, ekstensi bertanggung jawab untuk membuat pintasan.
Item Buat Pintasan juga ditambahkan ke menu File Windows Explorer dan ke menu pintasan normal.
Jika item dipilih, metode IContextMenu::InvokeCommand aplikasi Anda dipanggil dengan anggota lpVerb dari struktur CMINVOKECOMMANDINFO diatur ke tautan. Aplikasi Anda bertanggung jawab untuk membuat tautan.
SFGAO_STORAGE
0x00000008
 Item yang ditentukan dapat terikat ke objek IStorage melalui IShellFolder::BindToObject. Untuk informasi selengkapnya tentang kemampuan manipulasi namespace, lihat IStorage.
SFGAO_CANRENAME
0x00000010
 Item yang ditentukan dapat diganti namanya. Perhatikan bahwa nilai ini pada dasarnya adalah saran; tidak semua klien namespace memungkinkan item diganti namanya. Namun, mereka yang memang harus memiliki set atribut ini.
SFGAO_CANDELETE
0x00000020
 Item yang ditentukan dapat dihapus.
SFGAO_HASPROPSHEET
0x00000040
 Item yang ditentukan memiliki lembar properti.
SFGAO_DROPTARGET
0x00000100
 Item yang ditentukan adalah target penghilangan.
SFGAO_CAPABILITYMASK
0x00000177
 Bendera ini adalah masker untuk atribut kemampuan: SFGAO_CANCOPY, SFGAO_CANMOVE, SFGAO_CANLINK, SFGAO_CANRENAME, SFGAO_CANDELETE, SFGAO_HASPROPSHEET, dan SFGAO_DROPTARGET. Penelepon biasanya tidak menggunakan nilai ini.
SFGAO_SYSTEM
0x00001000
 Windows 7 dan yang lebih baru. Item yang ditentukan adalah item sistem.
SFGAO_ENCRYPTED
0x00002000
 Item yang ditentukan dienkripsi dan mungkin memerlukan presentasi khusus.
SFGAO_ISSLOW
0x00004000
 Mengakses item (melalui IStream atau antarmuka penyimpanan lainnya) diharapkan menjadi operasi yang lambat. Aplikasi harus menghindari akses item yang ditandai dengan SFGAO_ISSLOW.
Catatan: Membuka aliran untuk item umumnya merupakan operasi yang lambat setiap saat. SFGAO_ISSLOW menunjukkan bahwa diperkirakan akan sangat lambat, misalnya dalam kasus koneksi jaringan lambat atau file offline (FILE_ATTRIBUTE_OFFLINE). Namun, mengkueri SFGAO_ISSLOW itu sendiri merupakan operasi yang lambat. Aplikasi harus meminta SFGAO_ISSLOW hanya pada utas latar belakang. Metode alternatif, seperti mengambil properti PKEY_FileAttributes dan pengujian untuk FILE_ATTRIBUTE_OFFLINE, dapat digunakan sebagai pengganti panggilan metode yang melibatkan SFGAO_ISSLOW.
SFGAO_GHOSTED
0x00008000
 Item yang ditentukan ditampilkan sebagai redup dan tidak tersedia untuk pengguna.
SFGAO_LINK
0x00010000
 Item yang ditentukan adalah pintasan.
SFGAO_SHARE
0x00020000
 Objek yang ditentukan dibagikan.
SFGAO_READONLY
0x00040000
 Item yang ditentukan bersifat baca-saja. Dalam kasus folder, ini berarti bahwa item baru tidak dapat dibuat di folder tersebut. Ini tidak boleh dikacaukan dengan perilaku yang ditentukan oleh bendera FILE_ATTRIBUTE_READONLY yang diambil oleh IColumnProvider::GetItemData dalam struktur SHCOLUMNDATA . FILE_ATTRIBUTE_READONLY tidak memiliki arti untuk folder sistem file Win32.
SFGAO_HIDDEN
0x00080000
 Item disembunyikan dan tidak boleh ditampilkan kecuali opsi Perlihatkan file dan folder tersembunyi diaktifkan di Pengaturan Folder.
SFGAO_DISPLAYATTRMASK
0x000FC000
 Jangan gunakan.
SFGAO_NONENUMERATED
0x00100000
 Item adalah item nonenumerasi dan harus disembunyikan. Mereka tidak dikembalikan melalui enumerator seperti yang dibuat oleh metode IShellFolder::EnumObjects .
SFGAO_NEWCONTENT
0x00200000
 Item berisi konten baru, seperti yang didefinisikan oleh aplikasi tertentu.
SFGAO_CANMONIKER
 Tidak didukung.
SFGAO_HASSTORAGE
 Tidak didukung.
SFGAO_STREAM
0x00400000
 Menunjukkan bahwa item memiliki aliran yang terkait dengannya. Aliran tersebut dapat diakses melalui panggilan ke IShellFolder::BindToObject atau IShellItem::BindToHandler dengan IID_IStream dalam parameter riid .
SFGAO_STORAGEANCESTOR
0x00800000
 Anak-anak item ini dapat diakses melalui IStream atau IStorage. Anak-anak itu ditandai dengan SFGAO_STORAGE atau SFGAO_STREAM.
SFGAO_VALIDATE
0x01000000
 Ketika ditentukan sebagai input, SFGAO_VALIDATE menginstruksikan folder untuk memvalidasi bahwa item yang terkandung dalam folder atau array item Shell ada. Jika satu atau beberapa item tersebut tidak ada, IShellFolder::GetAttributesOf dan IShellItemArray::GetAttributes mengembalikan kode kegagalan. Bendera ini tidak pernah dikembalikan sebagai nilai [keluar].
Ketika digunakan dengan folder sistem file, SFGAO_VALIDATE menginstruksikan folder untuk membuang properti cache yang diambil oleh klien IShellFolder2::GetDetailsEx yang mungkin telah terakumulasi untuk item yang ditentukan.
SFGAO_REMOVABLE
0x02000000
 Item yang ditentukan berada pada media yang dapat dilepas atau merupakan perangkat yang dapat dilepas sendiri.
SFGAO_COMPRESSED
0x04000000
 Item yang ditentukan dikompresi.
SFGAO_BROWSABLE
0x08000000
 Item yang ditentukan dapat dihosting di dalam browser web atau bingkai Windows Explorer.
SFGAO_FILESYSANCESTOR
0x10000000
 Folder yang ditentukan adalah folder sistem file atau berisi setidaknya satu turunan (anak, cucu, atau yang lebih baru) yang merupakan folder sistem file (SFGAO_FILESYSTEM).
SFGAO_FOLDER
0x20000000
 Item yang ditentukan adalah folder. Beberapa item dapat ditandai dengan SFGAO_STREAM dan SFGAO_FOLDER, seperti file terkompresi dengan ekstensi nama file .zip. Beberapa aplikasi mungkin menyertakan bendera ini saat menguji item yang merupakan file dan kontainer.
SFGAO_FILESYSTEM
0x40000000
 Folder atau file yang ditentukan adalah bagian dari sistem file (yaitu, mereka adalah file, direktori, atau direktori akar). Nama item yang diurai dapat diasumsikan sebagai jalur sistem file Win32 yang valid. Jalur ini dapat berupa UNC atau berbasis huruf kandar.
SFGAO_STORAGECAPMASK
0x70C50008
 Bendera ini adalah masker untuk atribut kemampuan penyimpanan: SFGAO_STORAGE, SFGAO_LINK, SFGAO_READONLY, SFGAO_STREAM, SFGAO_STORAGEANCESTOR, SFGAO_FILESYSANCESTOR, SFGAO_FOLDER, dan SFGAO_FILESYSTEM. Penelepon biasanya tidak menggunakan nilai ini.
SFGAO_HASSUBFOLDER
0x80000000
 Folder yang ditentukan memiliki subfolder. Atribut SFGAO_HASSUBFOLDER hanya nasihat dan mungkin dikembalikan oleh implementasi folder Shell meskipun tidak berisi subfolder. Namun, perhatikan bahwa konverter—gagal mengembalikan SFGAO_HASSUBFOLDER—secara definitif menyatakan bahwa objek folder tidak memiliki subfolder.
Mengembalikan SFGAO_HASSUBFOLDER disarankan setiap kali diperlukan sejumlah besar waktu untuk menentukan apakah ada subfolder. Misalnya, Shell selalu mengembalikan SFGAO_HASSUBFOLDER ketika folder terletak di drive jaringan.
SFGAO_CONTENTSMASK
0x80000000
 Bendera ini adalah masker untuk atribut konten, saat ini hanya SFGAO_HASSUBFOLDER. Penelepon biasanya tidak menggunakan nilai ini.
SFGAO_PKEYSFGAOMASK
0x81044000
 Masker yang digunakan oleh properti PKEY_SFGAOFlags untuk menentukan atribut yang dianggap menyebabkan perhitungan lambat atau konteks kurang: SFGAO_ISSLOW, SFGAO_READONLY, SFGAO_HASSUBFOLDER, dan SFGAO_VALIDATE. Penelepon biasanya tidak menggunakan nilai ini.

Persyaratan

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

Lihat juga

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

IShellItem::GetAttributes

IShellItemArray::GetAttributes