ADS_PREFERENCES_ENUM'enumerazione (iads.h)

Articolo
08/24/2023

L'enumerazione ADS_PREFERENCES_ENUM specifica le preferenze di query del provider OLE DB per ADSI.

Sintassi

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0022 {
  ADSIPROP_ASYNCHRONOUS = 0,
  ADSIPROP_DEREF_ALIASES = 0x1,
  ADSIPROP_SIZE_LIMIT = 0x2,
  ADSIPROP_TIME_LIMIT = 0x3,
  ADSIPROP_ATTRIBTYPES_ONLY = 0x4,
  ADSIPROP_SEARCH_SCOPE = 0x5,
  ADSIPROP_TIMEOUT = 0x6,
  ADSIPROP_PAGESIZE = 0x7,
  ADSIPROP_PAGED_TIME_LIMIT = 0x8,
  ADSIPROP_CHASE_REFERRALS = 0x9,
  ADSIPROP_SORT_ON = 0xa,
  ADSIPROP_CACHE_RESULTS = 0xb,
  ADSIPROP_ADSIFLAG = 0xc
} ADS_PREFERENCES_ENUM;

Costanti


`ADSIPROP_ASYNCHRONOUS` Valore: 0 Richiede una ricerca asincrona.
`ADSIPROP_DEREF_ALIASES` Valore: 0x1 Specifica che gli alias degli oggetti trovati devono essere risolti. Usare ADS_DEREFENUM per specificare come eseguire questa operazione.
`ADSIPROP_SIZE_LIMIT` Valore: 0x2 Specifica il limite di dimensioni che il server deve osservare in una ricerca. Il limite di dimensioni è il numero massimo di oggetti restituiti. Un valore zero indica che non viene imposto alcun limite di dimensioni. Il server smette di cercare dopo aver raggiunto il limite di dimensioni e restituisce i risultati accumulati fino a quel punto.
`ADSIPROP_TIME_LIMIT` Valore: 0x3 Specifica il limite di tempo, in secondi, che il server deve osservare in una ricerca. Un valore zero indica che non viene imposto alcun limite di tempo. Quando viene raggiunto il limite di tempo, il server interrompe la ricerca e restituisce i risultati accumulati a tale punto.
`ADSIPROP_ATTRIBTYPES_ONLY` Valore: 0x4 Indica che la ricerca deve ottenere solo il nome degli attributi a cui sono stati assegnati i valori.
`ADSIPROP_SEARCH_SCOPE` Valore: 0x5 Specifica l'ambito di ricerca che deve essere osservato dal server. Per altre informazioni sulle impostazioni appropriate, vedere l'enumerazione ADS_SCOPEENUM .
`ADSIPROP_TIMEOUT` Valore: 0x6 Specifica il limite di tempo, in secondi, che un client attenderà che il server restituisca il risultato.
`ADSIPROP_PAGESIZE` Valore: 0x7 Specifica le dimensioni della pagina in una ricerca in pagina. Per ogni richiesta dal client, il server restituisce, al massimo, il numero di oggetti impostato in base alle dimensioni della pagina.
`ADSIPROP_PAGED_TIME_LIMIT` Valore: 0x8 Specifica il limite di tempo, in secondi, che il server deve osservare per cercare una pagina di risultati; questo è contrario al limite di tempo per l'intera ricerca.
`ADSIPROP_CHASE_REFERRALS` Valore: 0x9 Specifica che le segnalazioni possono essere inseguite. Se la ricerca radice non viene specificata nel contesto di denominazione del server o quando i risultati della ricerca superano un contesto di denominazione (ad esempio, quando si hanno domini figlio e si esegue la ricerca nel dominio padre), il server invia un messaggio di riferimento al client che può scegliere di ignorare o inseguire. Per impostazione predefinita, questa opzione è impostata su ADS_CHASE_REFERRALS_EXTERNAL. Per altre informazioni sulle segnalazioni inseguimento, vedere ADS_CHASE_REFERRALS_ENUM.
`ADSIPROP_SORT_ON` Valore: 0xa Specifica che il server ordina il set di risultati. Usare la struttura ADS_SORTKEY per specificare le chiavi di ordinamento.
`ADSIPROP_CACHE_RESULTS` Valore: 0xb Specifica se il risultato deve essere memorizzato nella cache sul lato client. Per impostazione predefinita, ADSI memorizza nella cache il set di risultati. La disattivazione di questa opzione può essere più auspicabile per i set di risultati di grandi dimensioni.
`ADSIPROP_ADSIFLAG` Valore: 0xc Consente al client OLEDB di specificare i flag di associazione da usare quando si associa al server. I valori validi sono quelli consentiti da ADsOpenObject. È accessibile dagli script ADO usando il nome della proprietà "FLAG ADSI".

Commenti

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 nell'applicazione VBScript. Per usare le costanti simboliche, come procedura di programmazione valida, scrivere dichiarazioni esplicite di tali costanti, come fatto qui, nell'applicazione VBScript.