Mengembalikan Properti dari Penangan Filter
Properti diekstrak dari item menggunakan penangan properti terdaftar, atau menggunakan filter yang terdaftar untuk jenis file tertentu. Handler filter (implementasi antarmuka IFilter ) dapat menginterpretasikan konten jenis file dalam sejumlah cara.
Topik ini diatur sebagai berikut:
Pemfilteran Properti
Praktik terbaik untuk pemfilteran properti tercantum dalam tabel berikut.
| Metode | Deskripsi |
|---|---|
| IFilter::Init | Mengembalikan enumerasi IFILTER_FLAGS . Jika anggota IFILTER_FLAGS_OLE_PROPERTIES enumerasi ini diatur ke satu, maka Windows Search menggunakan antarmuka antarmuka IPropertySetStorage dan IPropertyStorage untuk menghitung dan mengakses properti jenis nilai eksternal. |
| IFilter::GetChunk | Mengembalikan informasi dari dokumen dalam "gugus" dengan jenis gugus (teks atau nilai), nama, dan lokal. Gugus berisi satu properti dokumen. |
| IFilter::GetText | Mendapatkan properti jenis teks dari gugus. |
| IFilter::GetValue | Mendapatkan properti jenis nilai dari gugus. |
Ilustrasi berikut ini memperlihatkan contoh dokumen. Properti DocTitle jenis nilai eksternal (diperoleh menggunakan metode antarmuka IPropertySetStorage dan IPropertyStorage ) dan properti Book jenis nilai internal (diperoleh sebagai hasil dari implementasi IFilter kustom) menjelaskan dokumen secara keseluruhan. Properti Contents jenis teks dan Chapter menjelaskan konten dokumen. Saat memproses dokumen ini, handler filter (implementasi antarmuka IFilter ) mengidentifikasi dan mengekstrak properti ini.
Batasan Ukuran Properti
Ada dua batasan potensial untuk ukuran properti:
- Ukuran maksimum data yang diterima Windows Search per file.
- Ukuran maksimum per properti seperti yang didefinisikan dalam file deskripsi properti.
Saat ini, Windows Search tidak menggunakan ukuran properti yang ditentukan saat menghitung jumlah data yang diterimanya dari item. Sebaliknya, batas yang digunakan Windows Search adalah produk dari ukuran file dan MaxGrowFactor (ukuran file N * MaxGrowFactor) yang dibaca dari registri.
MaxGrowFactor Defaultnya adalah empat.
HKEY_LOCAL_MACHINE
SOFTWARE
Microsoft
Gathering Manager
MaxGrowFactor
Akibatnya, jika jenis file Anda cenderung kecil dalam ukuran total tetapi memiliki properti yang lebih besar, Windows Search mungkin tidak menerima semua data properti yang ingin Anda keluarkan. Namun, Anda dapat meningkatkan MaxGrowFactor agar sesuai dengan kebutuhan Anda.
Sumber Daya Tambahan
- Sampel kode IFilterSample , tersedia di GitHub, menunjukkan cara membuat kelas dasar IFilter untuk mengimplementasikan antarmuka IFilter .
- Untuk gambaran umum proses pengindeksan, lihat Proses Pengindeksan.
- Untuk gambaran umum jenis file, lihat Jenis File.
- Untuk mengkueri atribut asosiasi file untuk jenis file, lihat PerceivedTypes, SystemFileAssociations, dan Pendaftaran Aplikasi.
- Untuk gambaran umum properti dan penangan properti, dan daftar properti sistem yang bisa Anda gunakan untuk format file Anda, lihat Mengembangkan Penangan Properti untuk Windows Search.
Topik terkait
Tentang Penangan Filter di Windows Search
Praktik Terbaik untuk Membuat Penangan Filter di Windows Search
Filter Handler yang Dikirim dengan Windows