ADS_DEREFENUM-Enumeration (iads.h)

Die ADS_DEREFENUM-Enumeration gibt den Prozess an, durch den Aliaseferent werden.

Syntax

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;

Konstanten

 
ADS_DEREF_NEVER
Wert: 0
Beim Suchen oder Suchen des Basisobjekts der Suche werden keine Aliase abgeleitet.
ADS_DEREF_SEARCHING
Wert: 1
Hebt den Verweis auf Aliase beim Durchsuchen von untergeordneten Elementen des Basisobjekts auf, jedoch nicht beim Suchen des Basisobjekts selbst.
ADS_DEREF_FINDING
Wert: 2
Hebt den Verweis auf Aliase beim Suchen des Basisobjekts für die Suche, jedoch nicht beim Durchsuchen der zugehörigen untergeordneten Elemente auf.
ADS_DEREF_ALWAYS
Wert: 3
Hebt den Verweis auf Aliase sowohl beim Suchen der untergeordneten Elemente als auch beim Suchen des Basisobjekts auf.

Hinweise

Die IDirectorySearch-Schnittstelle verwendet diese Konstanten, um das Verhalten des Aliasdeferencing festzulegen. Wenn keine Option angegeben ist, wird der Server standardmäßig ADS_DEREF_NEVER.

Hinweis Da VBScript keine Daten aus einer Typbibliothek lesen kann, erkennen VBScript-Anwendungen die oben definierten symbolischen Konstanten nicht. Verwenden Sie stattdessen die numerischen Konstanten, um die entsprechenden Flags in Ihren VBScript-Anwendungen festzulegen. Um die symbolischen Konstanten als gute Programmierpraxis zu verwenden, deklarieren Sie Explizit Konstanten, wie hier geschehen.
 

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie die Sucheinstellung für aliasdereferencing festgelegt wird. m_pSearch verweist auf einen Zeiger auf ein Objekt, das die IDirectorySearch-Schnittstelle implementiert.

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);

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Kopfzeile iads.h

Weitere Informationen

ADSI-Enumerationen

Idirectorysearch