指定搜尋範圍

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

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