Arama köklerini yönetme

Gezinme Kapsamı Yöneticisi (CSM), Windows Search gezinme kapsamına veri depolarınız için arama kökleri eklemenizi ve kaldırmanızı sağlar.

Bu konu aşağıdaki konuları içerir:

• Arama Kökleri Hakkında
• Başlamadan Önce
• Windows 7: Yeni Gezinme Kapsamı Yöneticisi API'si
• Tarama Kapsamına Kök Ekleme
• Tarama Kapsamından Kökleri Kaldırma
• Tarama Kapsamındaki Kökleri Listeleme
• İlgili konular

Arama kökleri hakkında

Arama kökü, belirli kapsamların dahil edilebileceği veya dışlanabileceği shell ad alanının tabanını tanımlar ve genellikle bir protokoldeki numaralandırılabilir en üst düzey kapsayıcıdır. Bu deponun hangi bölümlerinin dizine alınması gerektiğini veya dizine alınmaması gerektiğini belirtmez; yalnızca bir içerik deposu olduğunu ve kayıtlı bir protokol işleyicisi ile ilişkili olduğunu gösterir. Arama kök URL'sini tanımlama söz dizimi protokolü, depoyu veya kullanıcının güvenlik tanımlayıcısını, yolu ve isteğe bağlı olarak belirli bir öğeyi (dosya gibi) içerir. Aşağıdaki örneklerde, bir arama kökü için söz diziminin iki biçimi gösterilmektedir.

<protocol>://<store or SID>\<path>\[item]
or
<protocol>://<store or SID>/<path>/[item]

Protokol < segmenti >, dosya protokolü hariç iki (2) eğik çizgi ('/') ile izlenmelidir; dosya protokolü ise üç eğik çizgi gerektirir (file:///). Site <veya SID> kesimi, arama kökü kullanıcıya özgü olacak şekilde tasarlanıyorsa bir içerik depoyu veya kullanıcı güvenlik tanımlayıcısını temsil eder. Yol <> kesimi, dizinler veya klasörler gibi bir kapsayıcı kümesidir ve '*' joker karakterini içerebilir. <Öğe> kesimi isteğe bağlıdır ve '*' joker karakterini de içerebilir. Öğe eklemezseniz, yol kesiminizi eğik çizgiyle tamamladığınızdan emin olun; aksi takdirde dizin oluşturucu son altcontainer'ın bir öğe olduğunu varsayar.

Örneğin, özel bir uygulama için *.myext türünde dosyaları işlemek için bir protokol işleyicisi (myPH) uyguladığınızı varsayalım. Bu dosyaların tümü yerel bilgisayardaki WorkteamA\ProjectFiles klasöründe bulunur. Bunun için arama kökü şöyle görünebilir:

• myPH:///C:\WorkteamA\ProjectFiles\

Tüm .myext dosyalarını eklemeyi planladığınızı ancak dizine bu kapsayıcıdan başka hiçbir şey eklemeyebilirsiniz. Bunun için arama kökü şöyle görünebilir:

• myPH:///C:\WorkteamA\ProjectFiles\*.myext.

Joker karakter desenleri URL'leri '*' joker karakterini kullanarak tanımlar ve URL yerine desen olarak kabul edilir, ancak terimler genellikle birbirinin yerine kullanılır. Örneğin, file:///C:\ProjectA\*\data\ aşağıdaki URL'ler ile eşleşir:

• C:\ProjectA\version1\data\
• C:\ProjectA\version2\data\

Ancak bu desen şu URL ile eşleşmiyor:

• C:\ProjectA\version1\temp\data\

Dizin oluşturucunun gezinme kapsamında olmayan kapsayıcılar için yeni arama kökleri oluşturmanız gerekir. C:\ParentScope yolu zaten gezinme kapsamına eklenmişse, alt kapsamın daha önce dışlandığını biliyorsanız C:\ParentScope\ChildScope için yeni bir arama kökü eklemenize gerek yoktur.

Windows Search seçeneklerini ayarlamak için kullanıcı arabirimi, aramalarının kapsam kurallarını daraltabilmeleri için kullanıcılara arama köklerini görüntüler. Özel protokol işleyiciniz, kapsayıcınız ve/veya uygulamanız için yükleme işleminin bir parçası olarak, ekleme ve dışlama kurallarıyla bir varsayılan gezinme kapsamı tanımlayabilirsiniz. Bu kurallar son kullanıcılara konum olarak sunulur. Kullanıcılar önceden tanımlanmış arama kökünüzün alt dizinlerinde gezinebilir ve aramalara eklemek istedikleri öğeleri seçebilir veya dışlamak istedikleri öğeleri temizleyebilir.

Başlamadan önce

Gezinme Kapsamı Yöneticisi (CSM) arabirimlerinden herhangi birini kullanabilmeniz için aşağıdaki önkoşul adımlarını gerçekleştirmeniz gerekir:

1. CrawlSearchManager nesnesini oluşturun ve ISearchManager arabirimini alın.
2. ISearchCatalogManager arabiriminin bir örneğini almak için "SystemIndex" için ISearchManager::GetCatalog çağrısı yapın.
3. ISearchCrawlScopeManager arabiriminin bir örneğini almak için ISearchCatalogManager::GetCrawlScopeManager çağrısı yapın.

Gezinme Kapsamı Yöneticisi'ne (CSM) herhangi bir değişiklik yaptıktan sonra ISearchCrawlScopeManager::SaveAll çağrısı yapmalısınız. Bu yöntem parametre almaz ve başarıda S_OK döndürür.

Windows 7: yeni Gezinme Kapsamı Yöneticisi API'si

Windows 7 ve sonraki sürümlerde ISearchCrawlScopeManager2, ISearchCrawlScopeManager arabiriminin işlevselliğini genişletir. ISearchCrawlScopeManager2::GetVersion yöntemi, CSM'nin durumunun değiştiğinde istemcileri bilgilendiren Gezinme Kapsamı Yöneticisi (CSM) sürümünü alır. ISearchCrawlScopeManager2::GetVersion çapraz işlem çağrısına neden olmaz. İşlev başarılı olursa, döndürülen işaretçi, istemci UnmapViewOfFile'ı bu işaretçi üzerinde ve CloseHandle'ı döndürülen tanıtıcı üzerinde çağırana kadar geçerli kalır.

Tarama kapsamına kök dizin ekleme

ISearchCrawlScopeManager, arama motoruna taranacak ve/veya izlenecek kapsayıcılar ile bu kapsayıcıların altındaki dahil edilecek veya hariç tutulacak öğeler hakkında bilgi verir. Yeni bir arama kökü eklemek için bir ISearchRoot nesnesi örneği açın, kök öznitelikleri ayarlayın ve ISearchCrawlScopeManager::AddRoot çağrısı yapın ve ISearchRoot nesnenize bir işaretçi geçirin. Arama kök URL'si, daha önce açıklanan arama köküyle aynı formu alır.

Aşağıdaki tabloda ISearchRoot için ilgili put yöntemleri açıklanmaktadır; arabiriminin diğer put yöntemleri şu anda Windows Search tarafından kullanılmaz. Daha iyi güvenlik sağlamak için kullanıcıların güvenlik tanımlayıcılarını (SID) tüm köklere dahil etmeyi öneriyoruz. Kullanıcıya özgü kökler daha güvenlidir çünkü sorgular her bir kullanıcının işlemi olarak çalıştırılır ve bu, bir kullanıcının başka bir kullanıcının gelen kutusundan dizine alınan öğeleri görmesini önler.

Varsayılan olarak, arama kökü eklediğinizde dizin oluşturucu bir kapsamda gezinmez. Kök için bir ekleme kuralı da eklemeniz gerekir. Bir uygulama için kullanıcıya özgü kök eklemek istiyorsanız, uygulama başlatıldığında bu uygulamanın yeni kullanıcılar için uygun kökleri eklemesi gerekir.

Yeni kullanıcılara uygun kökleri eklemek için:

1. Kullanıcının SID'sini alın.
2. Bu SID için var olup olmadığını denetlemek için tüm kökleri numaralandır.
3. Gerekirse SID kullanarak yeni bir kök ekleyin.

Gezinme kapsamından kökler kaldırılıyor

Artık bu URL'nin dizine alınmasını istemediğinizde gezinme kapsamından bir kök kaldırmak için ISearchCrawlScopeManager kullanabilirsiniz. Bir kökün kaldırılması, bu URL'nin tüm kapsam kurallarını da siler. Örneğin, bir içerik deposunu ve/veya protokol işleyicisini bir sistemden kaldırmak istediğinizi varsayalım. Uygulamayı kaldırabilir, tüm verileri kaldırabilir ve ardından arama kökünü gezinme kapsamından kaldırabilirsiniz. Gezinme Kapsamı Yöneticisi kök ve kökle ilişkili tüm kapsam kurallarını kaldırır.

Var olan bir arama kökünü kaldırmak için, kaldırmak istediğiniz arama köküyle ISearchCrawlScopeManager::RemoveRoot öğesini çağırın. Arama kök URL'si, daha önce açıklanan arama köküyle aynı formu alır. Bu yöntem, kök bulunamazsa S_FALSE döndürür ve bulunan bir kökü kaldırırken bir hata oluştuysa bir hata kodu döndürür.

Arama kökünü kaldırmak, Windows Search seçeneklerinin kullanıcı arabiriminden URL'yi de kaldırır, böylece kullanıcılar kullanıcı arabirimini kullanarak bu kapsayıcıyı veya konumu yeniden ekleyemeyebilir. Ayrıca, bir arama kökünün tüm kullanıcı kümesi geçersiz kılmalarını kaldırmak ve özgün arama kökü ve kapsam kurallarına geri dönmek de mümkündür. Daha fazla bilgi için bkz. Kapsam Kurallarını Yönetme.

Tarama kapsamındaki kök dizinler listeleniyor.

CSM, arama köklerini standart com stili numaralandırıcı arabirimi IEnumSearchRoots kullanarak numaralandırır. Arama köklerini bir dizi amaç için numaralandırmak için bu arabirimi kullanabilirsiniz. Örneğin, gezinme kapsamının tamamını bir kullanıcı arabiriminde görüntülemek veya belirli bir kökün veya bir kökün alt öğesinin zaten gezinme kapsamında olup olmadığını keşfetmek isteyebilirsiniz.

İlgili konular

Referans

ISearchCrawlScopeManager

ISearchRoot

IEnumSearchRoots

Kavramsal

Gezinme Kapsamı Yöneticisi Kullanarak

Kapsam Kurallarını Yönetme