enumerazione ADS_CHASE_REFERRALS_ENUM (iads.h)

Articolo
08/24/2023

L'enumerazione ADS_CHASE_REFERRALS_ENUM specifica se e come si verifica il rilevamento delle segnalazioni. Quando un server determina che altri server contengono dati pertinenti, in parte o in tutto, possono fare riferimento al client a un altro server per ottenere il risultato. La ricerca di segnalazioni è l'azione eseguita da un client per contattare il server a cui fa riferimento per continuare la ricerca della directory.

Sintassi

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0024 {
  ADS_CHASE_REFERRALS_NEVER = 0,
  ADS_CHASE_REFERRALS_SUBORDINATE = 0x20,
  ADS_CHASE_REFERRALS_EXTERNAL = 0x40,
  ADS_CHASE_REFERRALS_ALWAYS
} ADS_CHASE_REFERRALS_ENUM;

Costanti


`ADS_CHASE_REFERRALS_NEVER` Valore: 0 Il client non deve mai inseguire il server a cui fa riferimento. Se si imposta questa opzione, un client non contatterà altri server in un processo di riferimento.
`ADS_CHASE_REFERRALS_SUBORDINATE` Valore: 0x20 Il client insegue solo le segnalazioni subordinate che sono un contesto di denominazione subordinato in un albero di directory. Ad esempio, se la ricerca di base viene richiesta per "DC=Fabrikam,DC=Com" e il server restituisce un set di risultati e una segnalazione di "DC=Sales,DC=Fabrikam,DC=Com" nel server AdbSales, il client può contattare il server AdbSales per continuare la ricerca. Il provider LDAP ADSI disattiva sempre questo flag per le ricerche per pagina.
`ADS_CHASE_REFERRALS_EXTERNAL` Valore: 0x40 Il client insegui le segnalazioni esterne. Ad esempio, un client richiede un server A per eseguire una ricerca "DC=Fabrikam,DC=Com". Tuttavia, il server A non contiene l'oggetto, ma sa che un server indipendente, B, lo possiede. Fa quindi riferimento al client al server B.
`ADS_CHASE_REFERRALS_ALWAYS` Le segnalazioni vengono inseguite per il tipo subordinato o esterno.

Commenti

Usare le costanti di questa enumerazione per configurare le preferenze di ricerca per il rilevamento delle segnalazioni. L'azione equivale a assegnare i campi appropriati della struttura ADS_SEARCHPREF_INFO con elementi dell'ADS_CHASE_REFERRALS_ENUM e delle enumerazioni ADS_SEARCHPREF_ENUM. I valori di questa enumerazione possono essere usati anche con IADsObjectOptions per specificare se il rilevamento delle segnalazioni deve essere eseguito durante l'enumerazione degli oggetti in un oggetto contenitore.

L'interfaccia IADsNameTranslate ha un'implementazione parziale di ADS_CHASE_REFERRALS_ENUM tramite la proprietà ChaseReferral . Se la proprietà ChaseReferral è impostata su zero (0), è uguale a quella di specificare ADS_CHASE_REFERRALS_NEVER (0). Se viene usato un valore diverso da zero, è uguale a quello di specificare ADS_CHASE_REFERRALS_ALWAYS (0x60 ). IADsNameTranslate non implementa le opzioni ADS_CHASE_REFERRALS_SUBORDINATE (0x20 ) o ADS_CHASE_REFERRALS_EXTERNAL (0x40).

Il provider LDAP DI ADSI supporta le segnalazioni esterne per le ricerche impaginate, ma non supporta le segnalazioni subordinate durante il paging.

Nota Poiché VBScript non può leggere i dati da una libreria di tipi, le applicazioni VBScript non comprendono le costanti simboliche definite in precedenza. È consigliabile usare le costanti numeriche per impostare i flag appropriati nelle applicazioni VBScript. Se si desidera usare le costanti simboliche come una buona pratica di programmazione, è consigliabile rendere dichiarazioni esplicite di tali costanti, come fatto qui, nelle applicazioni VBScript.