ADS_DEREFENUM-Enumeration (iads.h)

Artikel
08/24/2023

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

Share via