Membuat Koneksi or Pencarian untuk Handler Protokol
Windows Explorer mengontrol pembuatan konektor pencarian untuk handler protokol melalui entri kunci registri. Melalui registri baik pelaksana maupun pihak ketiga dapat memungkinkan penangan protokol baru dan warisan untuk berpartisipasi dalam Pencarian Windows 7.
Topik ini diatur sebagai berikut:
- Tentang Koneksi or Pencarian untuk Penangan Protokol di Windows 7
- Mengaktifkan Penangan Protokol untuk Berpartisipasi dalam Pencarian
- Sumber Daya Tambahan
- Topik terkait
Tentang Koneksi or Pencarian untuk Penangan Protokol di Windows 7
Di Windows 7, pencarian dari menu Mulai atau Windows Explorer hanya menyertakan file di lokasi terindeks, dan item sistem non-file seperti penyimpanan data jarak jauh atau item handler protokol yang memiliki konektor pencarian. Selain menyertakan item handler protokol dalam lingkup menu Mulai dan pencarian Shell, konektor pencarian memungkinkan menu Mulai untuk mengelompokkan item handler protokol bersama-sama di hasil menu Mulai , dengan manfaat yang dihasilkan bahwa pengguna dapat mengklik header grup dan melihat hasil hanya dari handler protokol. Atau, pengguna dapat menavigasi ke folder Pencarian , membuka file konektor pencarian, dan melakukan pencarian yang hanya menyertakan item dari handler protokol tertentu yang terkait dengan konektor pencarian tersebut.
Ketika pengguna pertama kali memulai aplikasi yang mendaftarkan handler protokol, Windows Explorer menghasilkan file konektor pencarian (.search Koneksi or-ms) untuk handler protokol di folder Pencarian pengguna. Aplikasi dengan penangan protokol dapat memilih untuk menonaktifkan perilaku ini atau menyesuaikan nama dan deskripsi konektor pencarian penangan protokol.
Catatan
Lokasi folder Pencarian pengguna adalah %userprofile%\Searches, atau FOLDERID_SavedSearches. GUID untuk FOLDERID_SavedSearches adalah {7d1d3a04-debb-4115-95cf-2f29da2920da}.
Windows Explorer mengontrol pembuatan konektor pencarian untuk handler protokol melalui entri kunci registri yang dijelaskan di bagian berikut:
- Mengaktifkan Penangan Protokol untuk Berpartisipasi dalam Pencarian
- Menonaktifkan Pembuatan Koneksi or Pencarian Handler Protokol
- Menyesuaikan Nama, Deskripsi, atau FolderType untuk Koneksi or Pencarian Handler Protokol
- Memulihkan Koneksi or Pencarian Handler Protokol yang Dihapus
Catatan
Tidak ada cara terprogram untuk membuat konektor pencarian untuk handler protokol. Mereka harus dikonfigurasi melalui registri.
Mengaktifkan Penangan Protokol untuk Berpartisipasi dalam Pencarian
Kunci registri dan kemungkinan nilainya diuraikan dalam tabel berikut. Handler protokol dapat mengisi beberapa atau semua kunci registri ini di mana <protokol> diganti dengan nama protokol yang sebenarnya, seperti MAPI, file, atau csc, misalnya.
| Kunci Registri | Nilai yang mungkin | Jenis | Komentar |
|---|---|---|---|
| HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearch Koneksi ors\<protocol>\Version | Tidak ada (default). Jika tidak, itu adalah 1 atau lebih besar. | REG_DWORD | Nilai ini digunakan untuk mendeteksi perubahan pada pendaftaran templat lokasi untuk akar pencarian yang telah diproses. Jika tidak ada, gunakan 0 sebagai default. Atau, tingkatkan versi untuk memberi tahu Windows Explorer bahwa konektor pencarian harus diregenerasi karena versi handler protokol yang lebih baru telah diinstal. |
| HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearch Koneksi ors\<protocol>\DoNotCreateSearch Koneksi ors | Tidak ada (default). Jika tidak, atur ke 1. | REG_DWORD | Jika tidak ada, buat file .searchconnector-ms di folder Pencarian. Jika 1, tandai sebagai diproses dan jangan lakukan apa-apa. |
| HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearch Koneksi ors\<protocol>\Default\Description | String yang dapat dilokalkan yang berisi deskripsi konektor pencarian. | REG_SZ | Opsional. Ini digunakan dalam elemen Deskripsi dari file .searchconnector-ms. |
| HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearch Koneksi ors\<protocol>\Default\Name | String yang dilokalkan untuk memberi nama konektor pencarian. Digunakan sebagai nama file .searchconnector-ms. | REG_SZ | Setiap lokasi harus memiliki nama yang unik. Dengan tidak adanya nilai ini, nama tampilan yang disediakan oleh Antarmuka IShellFolder handler protokol akan digunakan. |
| HKEY_LOCAL_MACHINE\Software\Microsoft\Windows Search\PHSearch Koneksi ors\<protocol>\Default\FolderType | GUID yang mengidentifikasi FOLDERTYPEID untuk diterapkan ke konektor pencarian. | REG_SZ | Opsional. Digunakan dalam elemen folderType dari file .searchconnector-ms untuk menunjukkan templat apa yang harus digunakan untuk menampilkan hasil. Misalnya, nilai GUID FOLDERTYPEID_Documents. |
Menonaktifkan Pembuatan Koneksi or Pencarian Handler Protokol
Jika aplikasi Anda mengekspos item melalui handler protokol untuk digunakan dalam aplikasi itu sendiri dan Anda tidak ingin mengekspos item melalui Shell (di menu Mulai dan pencarian Windows Explorer), Anda perlu menonaktifkan pembuatan konektor pencarian untuk penangan protokol Anda.
Untuk menonaktifkan kumpulan pembuatan konektor pencarian DoNotCreateSearch Koneksi ors ke 0x00000001(1), seperti yang ditunjukkan pada contoh kunci registri berikut.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows Search
PHSearchConnectors
<protocol>
DoNotCreateSearchConnectors
Jika DoNotCreateSearch Koneksi ors diatur ke 1, maka kami sarankan Anda mengekspos properti System.Shell.OmitFromView pada setiap item yang diekspos oleh handler protokol, dan atur nilai properti ini ke TRUE. Melakukannya akan mencegah item handler protokol muncul di bawah grup File menu Mulai.
Jika DoNotCreateSearch Koneksi ors ada dan diatur ke nol, maka Windows Explorer akan membuat konektor pencarian untuk handler protokol, dan item handler protokol akan dikembalikan di menu Mulai dan pencarian Windows Explorer.
Menyesuaikan Nama, Deskripsi, atau FolderType untuk Koneksi or Pencarian Handler Protokol
Nama konektor pencarian digunakan tidak hanya untuk mengidentifikasi konektor pencarian di folder Pencarian , tetapi sebagai header grup untuk hasil di pencarian menu Mulai . Oleh karena itu, penting untuk memberikan nama deskriptif untuk konektor pencarian. Jika nama tidak disediakan dalam kunci registri, secara default Windows Explorer menggunakan nama yang disediakan oleh Antarmuka IShellFolder untuk akar pencarian dan deskripsi kosong penangan protokol. Anda dapat mengganti nama default melalui entri kunci registri tanpa harus mengganti nama Antarmuka IShellFolder. Meskipun tidak terlihat seperti nama konektor pencarian, Anda juga dapat mengambil alih deskripsi untuk konektor pencarian dengan memberikan deskripsi Anda sendiri.
Untuk mengambil alih nama atau deskripsi default, atur entri seperti yang diperlihatkan dalam contoh registri berikut.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows Search
PHSearchConnectors
<protocol>
Default
Name
Description
Selain itu, entri FolderType dapat diatur ke salah satu GUID FOLDERTYPEID . Nilainya harus guid aktual, dan bukan namanya. Misalnya, {94d6ddcc-4a68-4175-a374-bd584a510b78} daripada FOLDERTYPEID_Music. GUID untuk FOLDERTYPEID dapat diperoleh dalam file header Shlguid.h di Windows SDK.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows Search
PHSearchConnectors
<protocol>
Default
FolderType = {94d6ddcc-4a68-4175-a374-bd584a510b78}
Menggunakan Pengalihan String Registri
Anda dapat menggunakan string yang dialihkan untuk memastikan bahwa nama yang Anda berikan untuk konektor pencarian dapat dilokalkan. Anda dapat menyertakan string yang dapat dilokalkan untuk nama dan deskripsi kunci registri alih-alih memasukkan string aktual ke dalam registri.
Untuk menyertakan string yang dapat dilokalkan untuk nilai Nama atau Deskripsi, atur nilai seperti yang ditunjukkan dalam contoh kunci registri berikut.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows Search
PHSearchConnectors
<protocol>
Name = @dllname.dll,-resourceID
String yang dapat dilokalkan mengambil format berikut:
- @dllname.dll,-resourceIDMana:
- @dllname.dll adalah jalur ke DLL yang berisi sumber daya string
- resourceID adalah ID sumber daya bilangan bulat dari sumber daya string
Format untuk string tidak langsung, dan string tidak langsung yang ditambahkan dengan pengubah versi, dijelaskan dalam Fungsi SHLoadIndirectString.
Memulihkan Koneksi or Pencarian Handler Protokol yang Dihapus
Karena konektor pencarian adalah file di komputer pengguna, konektor dapat dihapus secara keliru. Untuk memulihkan semua konektor pencarian handler protokol yang dihapus, pulihkan pustaka default. Untuk melakukannya, buka Windows Explorer, klik kanan folder Pustaka , lalu pilih Pulihkan Pustaka Default.
Sumber Daya Tambahan
Topik terkait
-
Konseptual