enumerazione ADS_DEREFENUM (iads.h)

Articolo
03/09/2024

L'enumerazione ADS_DEREFENUM specifica il processo tramite il quale gli alias vengono dereferenziati.

Sintassi

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0020 {
  ADS_DEREF_NEVER = 0,
  ADS_DEREF_SEARCHING = 1,
  ADS_DEREF_FINDING = 2,
  ADS_DEREF_ALWAYS = 3
} ADS_DEREFENUM;

Costanti


`ADS_DEREF_NEVER` Valore: 0 Non dereferenzia gli alias durante la ricerca o l'individuazione dell'oggetto di base della ricerca.
`ADS_DEREF_SEARCHING` Valore: 1 Dereferenzia gli alias durante la ricerca nei subordinati dell'oggetto base, ma non durante l'individuazione dell'oggetto base stesso.
`ADS_DEREF_FINDING` Valore: 2 Dereferenzia gli alias durante l'individuazione dell'oggetto base della ricerca, ma non durante la ricerca nei subordinati.
`ADS_DEREF_ALWAYS` Valore: 3 Gli alias vengono dereferenziati durante la ricerca dei subordinati e durante l'individuazione dell'oggetto base della ricerca.

Commenti

L'interfaccia IDirectorySearch usa queste costanti per impostare il comportamento di dereferenziazione dell'alias. Se non viene specificata alcuna opzione, per impostazione predefinita il server viene ADS_DEREF_NEVER.

Nota Poiché VBScript non è in grado di leggere i dati da una libreria dei 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 procedura di programmazione consigliata, dichiarare in modo esplicito le costanti, come fatto qui.

Esempio

Nell'esempio di codice seguente viene illustrato come impostare la preferenza di ricerca per la dereferenziazione degli alias. m_pSearch fa riferimento a un puntatore a un oggetto che implementa l'interfaccia IDirectorySearch .

ADS_SEARCHPREF_INFO prefInfo[1];
HRESULT hr;
 
prefInfo[0].dwSearchPref   = ADS_SEARCHPREF_DEREF_ALIASES;
prefInfo[0].vValue.dwType  = ADSTYPE_INTEGER;
prefInfo[0].vValue.Integer = ADS_DEREF_ALWAYS;
hr = m_pSearch->SetSearchPreference(prefInfo, 1);

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	iads.h

Vedi anche

Enumerazioni ADSI

IDirectorySearch

Condividi tramite