Especificar el ámbito de búsqueda
Puede especificar el ámbito de una búsqueda como una búsqueda base, de un nivel o de subárbol. Use la marca ADS_SEARCHPREF_SEARCH_SCOPE con los valores de la enumeración ADS_SCOPEENUM para especificar el ámbito de búsqueda. En la lista siguiente se incluyen descripciones de los tipos de búsqueda:
- Base. Una búsqueda base limita la búsqueda al objeto base. El número máximo de objetos devueltos es siempre uno. Esta búsqueda es útil para comprobar la existencia de un objeto para recuperar la pertenencia a grupos. Por ejemplo, si tiene un nombre distintivo de objeto y debe comprobar la existencia del objeto en función de la ruta de acceso, puede usar una búsqueda de un nivel. Si se produce un error en la búsqueda, puede suponer que es posible que se haya cambiado el nombre del objeto o que se haya movido a otra ubicación, o que se le haya proporcionado información incorrecta sobre el objeto. Tenga en cuenta que debe almacenar el identificador único global (GUID) del objeto en lugar del nombre distintivo, si desea volver a visitar un objeto. El GUID siempre hará referencia al mismo objeto, independientemente de dónde se encuentre el objeto dentro de la jerarquía de directorios.
- Un nivel. Una búsqueda de un nivel está restringida a los elementos secundarios inmediatos de un objeto base, pero excluye el propio objeto base. Esta configuración puede realizar una búsqueda dirigida de objetos secundarios inmediatos de un objeto primario. Por ejemplo, considere un objeto primario P1 y sus elementos secundarios inmediatos: C1, C2 y C3. Una búsqueda de un nivel evalúa C1, C2 y C3 con los criterios de búsqueda, pero no evalúa P1. Use una búsqueda de un solo nivel para enumerar todos los elementos secundarios de un objeto. Una enumeración IADsContainer se traduce en una búsqueda de un nivel.
- Subárbol. Una búsqueda de subárboles (o una búsqueda en profundidad) incluye todos los objetos secundarios, así como el objeto base. Puede solicitar al proveedor LDAP que persiga referencias a otros servicios de directorio LDAP, incluidos otros dominios de directorio o bosques.