enumerazione ADS_SCOPEENUM (iads.h)

Articolo
02/29/2024

L'enumerazione ADS_SCOPEENUM specifica l'ambito di una ricerca di directory.

Sintassi

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0021 {
  ADS_SCOPE_BASE = 0,
  ADS_SCOPE_ONELEVEL = 1,
  ADS_SCOPE_SUBTREE = 2
} ADS_SCOPEENUM;

Costanti


`ADS_SCOPE_BASE` Valore: 0 Limita la ricerca all'oggetto base. Il risultato contiene, al massimo, un oggetto.
`ADS_SCOPE_ONELEVEL` Valore: 1 Cerca un livello di figlio immediato, escluso l'oggetto di base.
`ADS_SCOPE_SUBTREE` Valore: 2 Cerca l'intero sottoalbero, inclusi tutti gli elementi figlio e l'oggetto di base stesso.

Commenti

Se non si imposta in modo esplicito l'ambito di ricerca, il valore predefinito è ADS_SCOPE_SUBTREE.

Poiché VBScript non riesce a leggere i dati da una libreria di tipi, le applicazioni VBScript non riconoscono le costanti simboliche definite in precedenza. Usare invece le costanti numeriche per impostare i flag appropriati nelle applicazioni VBScript. Per usare le costanti simboliche come una buona pratica di programmazione, creare dichiarazioni esplicite di tali costanti, come fatto qui, nelle applicazioni VBScript.

Esempio

L'ambito di ricerca è uno dei client delle preferenze di ricerca può specificare. Nell'esempio di codice seguente viene illustrato come eseguire questa operazione usando la struttura ADS_SEARCHPREF_INFO , insieme agli elementi definiti nella ADS_SEARCHPREF_ENUM e all'enumerazione.

ADS_SEARCHPREF_INFO prefInfo;
prefInfo.dwSearchPref = ADS_SEARCHPREF_SEARCH_SCOPE;
prefInfo.vValue.dwType = ADSTYPE_INTEGER;
prefInfo.vValue.Integer = ADS_SCOPE_SUBTREE;