A keresési tartomány megadása

A keresés hatókörét alap-, egyszintű vagy részszintű keresésként is megadhatja. A keresési hatókör megadásához használja a ADS_SEARCHPREF_SEARCH_SCOPE jelölőt a ADS_SCOPEENUM számbavétel értékeivel. Az alábbi lista a keresési típusok leírását tartalmazza:

• Alap. Az alapszintű keresés az alapobjektumra korlátozza a keresést. A visszaadott objektumok maximális száma mindig egy. Ez a keresés hasznos annak ellenőrzéséhez, hogy létezik-e objektum a csoporttagság lekéréséhez. Ha például egy objektum megkülönböztető neve van, és az elérési út alapján ellenőriznie kell az objektum létezését, használhat egyszintű keresést. Ha a keresés sikertelen, feltételezheti, hogy az objektumot átnevezték vagy áthelyezték egy másik helyre, vagy rossz információt kapott az objektumról. Vegye figyelembe, hogy az objektum globálisan egyedi azonosítóját (GUID) kell tárolnia a megkülönböztető név helyett, ha újra meg szeretne látogatni egy objektumot. A GUID mindig ugyanarra az objektumra hivatkozik, függetlenül attól, hogy az objektum hol található a címtárhierarchiában.
• Egyszintű. Az egyszintű keresés az alapobjektum közvetlen gyermekeire korlátozódik, de magát az alapobjektumot kizárja. Ez a beállítás célzott keresést végezhet a szülőobjektum közvetlen gyermekobjektumai között. Vegyük például a P1 szülőobjektumot és annak közvetlen gyermekeit: C1, C2 és C3. Az egyszintű keresés a C1, C2 és C3 értéket értékeli ki a keresési feltételek alapján, de nem értékeli ki a P1 értéket. Egyszintű kereséssel számba lehet adni egy objektum összes gyermekét. Az IADsContainer enumerálás egyszintű keresésre fordítható.
• részfa. A részhalmaz-keresés (vagy mély keresés) az összes gyermekobjektumot és az alapobjektumot is magában foglalja. Kérheti az LDAP-szolgáltatót, hogy más LDAP-címtárszolgáltatásokra, köztük más címtártartományokra vagy erdőkre irányuló átirányításokat küldjön.