Bagikan melalui

Ikat Kunci String Konteks

  • Artikel

Sekumpulan kunci string yang digunakan dengan metode IBindCtx::RegisterObjectParam untuk menentukan konteks ikatan.

Terus-menerus Deskripsi
STR_AVOID_DRIVE_RESTRICTION_POLICY
 Diperkenalkan di Windows XP SP2. Tentukan konteks ikatan ini untuk mengizinkan klien sumber data mengambil alih kebijakan huruf drive tersembunyi dan mengaktifkan akses ke objek tampilan untuk sumber data pada drive yang diblokir.
Digunakan dengan IShellFolder::BindToObject atau IShellItem::BindToHandler.
Sistem mendukung kebijakan yang dikontrol administrator yang menyembunyikan huruf drive tertentu untuk memblokir pengguna mengakses drive tersebut melalui Windows Explorer. Ketika kebijakan ini aktif, hasilnya adalah bahwa melihat objek dan handler lain yang dibuat dengan metode IShellFolder::CreateViewObject akan gagal ketika dipanggil pada drive yang diblokir oleh kebijakan.
STR_BIND_DELEGATE_CREATE_OBJECT
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini untuk menyebabkan metode IShellFolder::BindToObject menggunakan objek yang ditentukan oleh parameter pbc untuk membuat objek target; dalam hal ini, objek yang ditentukan oleh parameter punk dalam panggilan IBindCtx::RegisterObjectParam harus mengimplementasikan antarmuka ICreateObject .
Digunakan dengan IShellFolder::BindToObject atau IShellItem::BindToHandler.
STR_BIND_FOLDER_ENUM_MODE
 Diperkenalkan di Windows 7. Diteruskan ke IShellFolder::P arseDisplayName dengan nilai FOLDER_ENUM_MODE untuk mengontrol mode enumerasi item yang diurai. Nilai FOLDER_ENUM_MODE diteruskan dalam konteks ikat melalui objek yang mengimplementasikan IObjectWithFolderEnumMode.
Item dengan mode enumerasi yang berbeda membandingkan secara kanonis (SHCIDS_CANONICALONLY) berbeda karena menghitung set item yang berbeda.
Jika item tidak mendukung mode enumerasi (karena bukan folder atau tidak menyediakan mode enumerasi), item tersebut dibuat dalam mode enumerasi default.
STR_BIND_FOLDERS_READ_ONLY
 Diperkenalkan di Windows 7. Diteruskan ke IShellFolder::P arseDisplayName bersama dengan STR_FILE_SYS_BIND_DATA. Ini memaksa penguraian sederhana sambil juga memeriksa file Desktop.ini di sepanjang jalur untuk mendapatkan string nama yang dilokalkan. Ini menghindari pemeriksaan untuk folder di sepanjang jalur, yang, dalam kasus folder yang mewakili server atau berbagi, dapat memakan waktu dan sumber daya yang luas. Desktop.ini file di-cache di beberapa lokasi, sehingga setidaknya akan seefisien pemeriksaan untuk atribut folder dan kemudian memeriksa Desktop.ini jika folder tersebut harus mengubah ou menjadi baca-saja.
STR_BIND_FORCE_FOLDER_SHORTCUT_RESOLVE
 Diperkenalkan di Windows XP SP2. Tentukan konteks ikatan ini untuk memaksa pintasan folder menyelesaikan tautan yang menunjuk ke targetnya.
Pintasan folder adalah item folder yang menunjuk ke item folder lain di namespace yang sama, menggunakan tautan (pintasan) untuk menahan IDList target. Tautan diselesaikan untuk melacak target jika dipindahkan atau diganti namanya. Misalnya, folder Windows XP My Network Places dan folder Windows Vista Computer bisa berisi pintasan folder yang dibuat dengan wizard Tambahkan Lokasi Jaringan . Untuk meningkatkan performa, metode IShellFolder::BindToObject tidak menyelesaikan tautan ke folder jaringan secara default.
Digunakan dengan IShellFolder::BindToObject atau IShellItem::BindToHandler.
STR_DONT_PARSE_RELATIVE
 Diperkenalkan di Windows XP. Tentukan konteks ikatan ini untuk mencegah panggilan ke metode IShellFolder::P arseDisplayName pada folder Desktop memperlakukan jalur relatif relatif terhadap desktop; dalam kasus seperti itu, penguraian gagal ketika konteks ikatan ini ditentukan.
STR_DONT_RESOLVE_LINK
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini untuk menginstruksikan IShellItem untuk tidak menyelesaikan target tautan yang diperoleh saat menggunakan GUID BHID_LinkTargetItem di IShellItem::BindToHandler.
STR_FILE_SYS_BIND_DATA
 Diperkenalkan di Windows XP. Tentukan konteks ikat ini untuk menyediakan metadata file ke metode IShellFolder::P arseDisplayName , yang digunakan alih-alih mencoba mengambil metadata file yang sebenarnya. Objek terkait harus mengimplementasikan IFileSystemBindData dan secara opsional juga dapat mengimplementasikan IFileSystemBindData2. Secara default, metode IShellFolder::P arseDisplayName memverifikasi bahwa file ada dan menggunakan metadata aktual file untuk mengisi daftar ID.
STR_FILE_SYS_BIND_DATA_WIN7_FORMAT
 Diperkenalkan di Windows 8.1. Tentukan konteks ikatan ini untuk menunjukkan bahwa data yang disediakan dalam konteks ikat STR_FILE_SYS_BIND_DATA harus digunakan untuk membuat daftar ItemID dalam format Windows 7."
STR_GET_ASYNC_HANDLER
 Diperkenalkan di Windows 7. Tentukan konteks ikatan ini saat handler diambil pada utas yang sama dengan UI. Setiap aktivitas intensif memori seperti yang melibatkan disk atau akses jaringan harus dihindari.
STR_GPS_BESTEFFORT
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini saat meminta handler IPropertySetStorage atau IPropertyStore . Nilai ini digunakan dengan IShellFolder::BindToObject. Lihat bendera GPS_BESTEFFORT untuk informasi selengkapnya.
STR_GPS_DELAYCREATION
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini saat meminta handler IPropertySetStorage atau IPropertyStore . Nilai ini digunakan dengan IShellFolder::BindToObject. Lihat bendera GPS_DELAYCREATION untuk informasi selengkapnya.
STR_GPS_FASTPROPERTIESONLY
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini saat meminta handler IPropertySetStorage atau IPropertyStore . Nilai ini digunakan dengan IShellFolder::BindToObject. Lihat bendera GPS_FASTPROPERTIESONLY untuk informasi selengkapnya.
STR_GPS_HANDLERPROPERTIESONLY
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini saat meminta handler IPropertySetStorage atau IPropertyStore . Nilai ini digunakan dengan IShellFolder::BindToObject. Lihat bendera GPS_HANDLERPROPERTIESONLY untuk informasi selengkapnya.
STR_GPS_NO_OPLOCK
 Diperkenalkan di Windows 7. Tentukan konteks ikatan ini saat meminta handler IPropertySetStorage atau IPropertyStore . Nilai ini digunakan dengan IShellFolder::BindToObject. Lihat bendera GPS_NO_OPLOCK untuk informasi selengkapnya.
STR_GPS_OPENSLOWITEM
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini saat meminta handler IPropertySetStorage atau IPropertyStore . Nilai ini digunakan dengan IShellFolder::BindToObject. Lihat bendera GPS_OPENSLOWITEM untuk informasi selengkapnya.
STR_IFILTER_FORCE_TEXT_FILTER_FALLBACK
 Hanya Windows Vista. Tentukan konteks ikatan ini untuk menyebabkan panggilan ke metode IShellFolder::BindToObject yang meminta antarmuka IFilter untuk objek sistem file mengembalikan filter teks jika tidak ada filter lain yang tersedia. Nilai ini tidak didefinisikan pada Windows 7.
STR_IFILTER_LOAD_DEFINED_FILTER
 Hanya Windows Vista. Tentukan konteks ikatan ini untuk menyebabkan panggilan ke metode IShellFolder::BindToObject yang meminta antarmuka IFilter untuk objek sistem file tidak mengembalikan filter fallback jika tidak ada filter terdaftar yang dapat ditemukan.
STR_INTERNAL_NAVIGATE
 Diperkenalkan di Windows Vista. Tentukan konteks ikat ini untuk mengaktifkan pemuatan riwayat dari aliran untuk navigasi internal saat metode IPersistHistory::LoadHistory dipanggil. Navigasi internal adalah navigasi dalam tampilan yang sama.
STR_INTERNETFOLDER_PARSE_ONLY_URLMON_BINDABLE
 Diperkenalkan di Windows 7. Tentukan konteks ikatan ini dengan STR_PARSE_PREFER_FOLDER_BROWSING ketika klien ingin penangan folder Internet Shell menghasilkan IDList untuk URL yang valid jika folder jenis DAV tidak dapat dibuat untuk URL tersebut. URL tidak diverifikasi untuk ada; hanya sintaksnya yang diperiksa dan memiliki penangan protokol terdaftar.
STR_ITEM_CACHE_CONTEXT
 Diperkenalkan di Windows 7. Tentukan konteks ikat ini untuk menginstruksikan implementasi IShellFolder::P arseDisplayName dan IPersistFolder3::InitializeEx untuk menyimpan objek pembantu intensif memori yang dapat ada di seluruh instansiasi item Shell alih-alih membuat ulang objek ini setiap kali item Shell dibuat. Objek terkait adalah objek konteks ikatan lain, awalnya kosong. Ini akan menghasilkan objek konteks ikatan terpisah, yang diakses melalui IBindCtx::GetObjectParam atau IBindCtx::Register.ObjectParam.
Pemanggil harus memilih perilaku ini dengan menyediakan parameter konteks ikatan ini saat memanggil SHCreateItemFromParsingName. Dengan demikian, Anda mengoptimalkan perilaku pengikatan ke beberapa nama penguraian secara berturut-turut. Masa pakai objek konteks ikatan harus mencakup beberapa instans item Shell dan konteks ikatan individualnya.
STR_NO_VALIDATE_FILENAME_CHARS
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini untuk memperbolehkan karakter nama file yang tidak valid muncul dalam nama file. Secara default, panggilan ke metode IShellFolder::P arseDisplayName menolak karakter yang ilegal dalam nama file. Konteks ikatan ini hanya bermakna bersama dengan konteks ikatan STR_FILE_SYS_BIND_DATA.
STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini untuk mengaktifkan panggilan ke metode IShellFolder::P arseDisplayName pada folder Desktop untuk mengurai URL. Jika konteks ikatan ini ditentukan, konteks tersebut akan mengambil alih STR_PARSE_PREFER_WEB_BROWSING.
STR_PARSE_AND_CREATE_ITEM
 Diperkenalkan di Windows 7. Tentukan konteks ikatan ini untuk menginstruksikan implementasi sumber data IShellFolder::P arseDisplayName untuk mengoptimalkan perilaku SHCreateItemFromParsingName.
Biasanya, SHCreateItemFromParsingName melakukan dua operasi pengikatan pada nama yang akan diurai: satu sampai dan satu ke IShellFolder::P arseDisplayName dan satu untuk membuat item Shell. Ketika konteks ikatan STR_PARSE_AND_CREATE_ITEM didukung, ikatan kedua dihindari dengan membuat item Shell selama IShellFolder::P arseDisplayName mengikat dan menyimpan item Shell melalui IParseAndCreateItem::SetItem. SHCreateItemFromParsingName kemudian menggunakan item Shell yang disimpan daripada membuatnya.
Parameter ini berlaku untuk elemen terakhir dari nama yang diurai. Misalnya, dalam nama "C:\Folder1\File.txt, data berlaku untuk File.txt.
STR_PARSE_DONT_REQUIRE_VALIDATED_URLS
 Hanya Windows Vista. Tentukan bahwa, saat mengurai URL, konteks ikatan ini seharusnya tidak mengharuskan URL ada sebelum membuat IDList untuk url tersebut. Tentukan konteks ikatan ini bersama dengan STR_PARSE_PREFER_FOLDER_BROWSING ketika klien menginginkan agar handler folder Internet Shell menghasilkan IDList untuk URL jika folder DAV tidak dapat dibuat untuk URL yang diberikan.
STR_PARSE_PARTIAL_IDLIST
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini untuk meneruskan item asli yang sedang diurai ulang ketika item tersebut disimpan sebagai objek IShellItem yang juga mengimplementasikan antarmuka IParentAndItem . Sebelum Windows 7 nilai ini tidak ditentukan dalam file header. Ini dapat didefinisikan oleh penelepon atau diteruskan sebagai nilai string L"ParseOriginalItem". Pada Windows 7, nilai didefinisikan dalam Shlobj.h. Perhatikan bahwa ini adalah header yang berbeda dari konstanta STR lainnya.
STR_PARSE_PREFER_FOLDER_BROWSING
 Diperkenalkan di Windows XP. Tentukan konteks ikatan ini untuk mengaktifkan panggilan ke metode IShellFolder::P arseDisplayName pada folder Desktop untuk mengurai URL seolah-olah itu adalah folder. Gunakan konteks ikatan ini untuk mengikat ke server WebDAV.
STR_PARSE_PREFER_WEB_BROWSING
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini untuk mencegah panggilan ke metode IShellFolder::P arseDisplayName pada URL penguraian formulir folder Desktop . Konteks ikatan ini dapat ditimpa oleh STR_PARSE_ALLOW_INTERNET_SHELL_FOLDERS.
STR_PARSE_PROPERTYSTORE
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini untuk mengambil alih penyimpanan properti default yang digunakan oleh metode IShellFolder::P arseDisplayName , dan gunakan penyimpanan properti yang ditentukan sebagai parameter ikat sebagai gantinya. Berlaku untuk mendelegasikan folder.
STR_PARSE_SHELL_PROTOCOL_TO_FILE_OBJECTS
 Diperkenalkan di Windows XP SP2. Tentukan konteks ikatan ini untuk mengaktifkan panggilan ke metode IShellFolder::P arseDisplayName pada folder Desktop untuk menggunakan notasi awalan "shell:" untuk mengakses file.
STR_PARSE_SHOW_NET_DIAGNOSTICS_UI
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini untuk menyebabkan panggilan ke metode IShellFolder::P arseDisplayName menampilkan dialog diagnostik jaringan jika penguraian jalur jaringan gagal.
STR_PARSE_SKIP_NET_CACHE
 Diperkenalkan di Windows Vista. Tentukan konteks ikatan ini untuk menyebabkan panggilan ke metode IShellFolder::P arseDisplayName melewati pemeriksaan cache berbagi jaringan dan menghubungi server jaringan secara langsung. Informasi tentang berbagi jaringan di-cache untuk meningkatkan performa, dan IShellFolder::P arseDisplayName memeriksa cache ini secara default.
STR_PARSE_TRANSLATE_ALIASES
 Diperkenalkan di Windows XP. Tentukan konteks ikat ini untuk meneruskan properti yang diurai ke metode IShellFolder::P arseDisplayName untuk namespace delegasi. Namespace dapat menggunakan properti yang diteruskan alih-alih mencoba mengurai nama itu sendiri.
STR_PARSE_WITH_PROPERTIES
 Hanya Windows Vista. Konteks ikatan penguraian yang digunakan untuk meneruskan sekumpulan properti dan nama item saat memanggil IShellFolder::P arseDisplayName. Objek dalam konteks ikat mengimplementasikan IPropertyStore dan diambil dengan memanggil IBindCtx::GetObjectParam.
DBFolder adalah sumber data Shell yang mewakili item dalam hasil pencarian dan tampilan berbasis kueri. DBFolder mengambil item ini dengan mengkueri sistem Windows Search. Item dalam hasil pencarian diidentifikasi melalui skema protokol, misalnya "file:" atau "mapi:". DBFolder menyediakan perilaku untuk item ini dengan mendelegasikan ke sumber data Shell yang dibuat untuk protokol ini. Lihat Mengembangkan Add-in Handler Protokol untuk informasi selengkapnya.
Ketika DBFolder mendelegasikan operasi penguraiannya ke sumber data Shell yang mendukung protokol Windows Search, konteks ikat ini menyediakan akses ke nilai yang dikembalikan dalam hasil kueri untuk item tersebut. Ini termasuk yang berikut:

Konteks ikatan ini juga dapat digunakan untuk mengurai item DBFolder jika klien memiliki sekumpulan properti yang menentukan item. Dalam hal ini nama kosong harus diteruskan ke IShellFolder::P arseDisplayName.
Sebelum Windows 7, nilai ini tidak ditentukan dalam file header. Ini dapat didefinisikan oleh pemanggil atau diteruskan sebagai nilai string-nya: L"ParseWithProperties". Pada Windows 7, nilai didefinisikan dalam Shlobj.h. Perhatikan bahwa ini adalah header yang berbeda dari tempat konstanta STR lainnya ditentukan.
STR_PROPERTYBAG_PARAM
 Diperkenalkan di Windows 8. Tentukan konteks ikatan ini untuk menunjukkan bahwa parameter konteks ikatan adalah tas properti (IPropertyBag) yang digunakan untuk meneruskan nilai VARIAN dalam konteks ikat. Lihat bagian Keterangan untuk detail lebih lanjut.
STR_SKIP_BINDING_CLSID
 Diperkenalkan di Windows XP. Tentukan konteks ikatan ini untuk menyebabkan panggilan ke metode IShellFolder::P arseDisplayName atau IShellFolder::BindToObject mengabaikan ekstensi namespace Shell tertentu saat mengurai atau mengikat. CLSID namespace layanan yang akan diabaikan disediakan oleh metode IPersist::GetClassID dari parameter ikat.
Catatan: Diperkenalkan di Windows 2000 SP3, nilai ini ditentukan dalam Shlobj.h hingga Windows XP, ketika dipindahkan ke Shobjidl.h.
STR_TRACK_CLSID
 Tidak digunakan.

Keterangan

Konteks ikatan digunakan untuk meneruskan parameter opsional ke fungsi yang memiliki parameter IBindCtx*. Parameter tersebut dinyatakan sebagai objek COM dan mungkin mengimplementasikan antarmuka yang digunakan untuk memodelkan data parameter. Beberapa konteks ikatan mewakili nilai Boolean, di mana TRUE menunjukkan objek yang hanya mengimplementasikan IUnknown dan FALSE menunjukkan tidak ada objek yang ada.

IShellFolder::P arseDisplayName, IShellFolder::BindToObject dan IShellItem::BindToHandler mengambil konteks ikat dan Anda dapat meneruskannya parameter melalui konteks ikat tersebut.

Beberapa konteks ikatan khusus untuk implementasi sumber data atau jenis handler tertentu.

Parameter konteks ikatan didefinisikan untuk digunakan dengan fungsi atau metode tertentu.

Saat meminta penyimpanan properti melalui IShellFolder, Anda dapat menentukan setara dengan GPS_DEFAULT dengan meneruskan parameter IBindCtx null. Anda juga dapat menentukan setara dengan GPS_READWRITE dengan melewati mode STGM_READWRITE | STGM_EXCLUSIVE dalam konteks ikatan.

Tas properti yang ditentukan oleh objek konteks ikat STR_PROPERTYBAG_PARAM berisi nilai tambahan yang dapat Anda akses dengan metode IPropertyBag::Read dan IPropertyBag::Write .

Nama properti Jenis Deskripsi
STR_ENUM_ITEMS_FLAGS VT_UI4 Diperkenalkan di Windows 8. Menentukan nilai SHCONTF yang akan diteruskan ke IShellFolder::EnumObjects saat Anda memanggil IShellItem::BindToHandler dengan BHID_EnumItems.
STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL VT_BOOL Diperkenalkan di Windows 7. Metode IShellFolder::P arseDisplayName mengatur properti ini untuk memberi tahu pemanggil bahwa IDList yang dikembalikan terikat ke ProgID yang ditentukan dengan STR_PARSE_WITH_EXPLICIT_PROGID atau aplikasi yang ditentukan dengan STR_PARSE_WITH_EXPLICIT_ASSOCAPP. Ketika STR_PARSE_EXPLICIT_ASSOCIATION_SUCCESSFUL tidak ada, ProgID atau aplikasi tidak terikat ke dalam IDList.
STR_PARSE_WITH_EXPLICIT_ASSOCAPP VT_BSTR Diperkenalkan di Windows 7. Tentukan properti ini untuk menyebabkan panggilan ke metode IShellFolder::P arseDisplayName mengembalikan IDList yang terikat ke penangan asosiasi jenis file untuk aplikasi.
STR_PARSE_WITH_EXPLICIT_PROGID VT_BSTR Diperkenalkan di Windows 7. Tentukan properti ini untuk menyebabkan panggilan ke metode IShellFolder::P arseDisplayName mengembalikan IDList yang terikat ke handler asosiasi file dari ProgID yang disediakan.

 

Lihat Sampel Penguraian Dengan Parameter untuk contoh penggunaan nilai konteks ikatan.

Persyaratan

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