Specifica dell'ambito di ricerca

È possibile specificare l'ambito di una ricerca come ricerca di base, un livello o sottoalbero. Usare il flag ADS_edizione StandardARCHPREF_edizione StandardARCH_SCOPE con i valori dell'enumerazione ADS_SCOPedizione Enterprise NUM per specificare l'ambito di ricerca. L'elenco seguente include le descrizioni dei tipi di ricerca:

  • Base. Una ricerca di base limita la ricerca all'oggetto di base. Il numero massimo di oggetti restituiti è sempre uno. Questa ricerca è utile per verificare l'esistenza di un oggetto per recuperare l'appartenenza al gruppo. Ad esempio, se si dispone di un nome distinto di un oggetto e è necessario verificare l'esistenza dell'oggetto in base al percorso, è possibile usare una ricerca a un livello. Se la ricerca non riesce, è possibile presupporre che l'oggetto sia stato rinominato o spostato in una posizione diversa oppure che siano state fornite informazioni errate sull'oggetto. Tenere presente che è necessario archiviare l'identificatore univoco globale (GUID) dell'oggetto anziché il nome distinto, se si desidera rivedere un oggetto. Il GUID farà sempre riferimento allo stesso oggetto, indipendentemente dalla posizione in cui si trova l'oggetto all'interno della gerarchia di directory.
  • Un livello. Una ricerca a un livello è limitata agli elementi figlio immediati di un oggetto di base, ma esclude l'oggetto di base stesso. Questa impostazione può eseguire una ricerca mirata di oggetti figlio immediati di un oggetto padre. Si consideri ad esempio un oggetto padre P1 e i relativi figli immediati: C1, C2 e C3. Una ricerca a un livello valuta C1, C2 e C3 rispetto ai criteri di ricerca, ma non valuta P1. Utilizzare una ricerca a un livello per enumerare tutti gli elementi figlio di un oggetto . Un'enumerazione IADsContainer si traduce in una ricerca a un livello.
  • Sottoalbero. Una ricerca sottoalbero (o una ricerca approfondita) include tutti gli oggetti figlio e l'oggetto di base. È possibile richiedere al provider LDAP di inseguire riferimenti ad altri servizi directory LDAP, inclusi altri domini di directory o foreste.