指定搜尋範圍

您可以將搜尋的範圍指定為基底、單層或子樹搜尋。 使用 ADS_SEARCHPREF_SEARCH_SCOPE 旗標搭配 ADS_SCOPEENUM 列舉的值來指定搜尋範圍。 下列清單包含搜尋類型的描述：

• 基底。 基底搜尋會將搜尋限制為基底物件。 傳回的物件數目上限一律為一。 此搜尋有助於確認物件是否存在以擷取群組成員資格。 例如，如果您有物件辨別名稱，而且您必須根據路徑驗證物件是否存在，您可以使用一層搜尋。 如果搜尋失敗，您可以假設物件可能已重新命名或移至不同的位置，或您收到有關物件的錯誤資訊。 請注意，如果您想要重新流覽物件，您應該將全域唯一識別碼儲存 (GUID) ，而不是辨別的名稱。 不論物件位於目錄階層中的位置為何，GUID 一律都會參考相同的物件。
• 一層。 單層級搜尋僅限於基底物件的立即子系，但會排除基底物件本身。 此設定可以針對父物件的立即子物件執行目標搜尋。 例如，請考慮父物件 P1 及其立即子系：C1、C2 和 C3。 一層搜尋會根據搜尋準則評估 C1、C2 和 C3，但不會評估 P1。 使用一層搜尋來列舉物件的所有子系。 IADsContainer列舉會轉譯為單層級搜尋。
• 子樹。 子樹搜尋 (或深層搜尋) 包含所有子物件以及基底物件。 您可以要求 LDAP 提供者追蹤其他 LDAP 目錄服務的轉介，包括其他目錄網域或樹系。