ADS_PREFERENCES_ENUM-Enumeration (iads.h)

Artikel
02/28/2024

Die ADS_PREFERENCES_ENUM-Enumeration gibt die Abfrageeinstellungen des OLE DB-Anbieters für ADSI an.

Syntax

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;

Konstanten


`ADSIPROP_ASYNCHRONOUS` Wert: 0 Fordert eine asynchrone Suche an.
`ADSIPROP_DEREF_ALIASES` Wert: 0x1 Gibt an, dass Aliase gefundener Objekte aufgelöst werden sollen. Verwenden Sie ADS_DEREFENUM , um anzugeben, wie dieser Vorgang ausgeführt werden soll.
`ADSIPROP_SIZE_LIMIT` Wert: 0x2 Gibt die Größenbeschränkung an, die der Server bei einer Suche beachten soll. Die Größenbeschränkung ist die maximale Anzahl zurückgegebener Objekte. Ein Nullwert gibt an, dass keine Größenbeschränkung festgelegt wird. Der Server beendet die Suche, sobald die Größenbeschränkung erreicht ist, und gibt die bis zu diesem Zeitpunkt gesammelten Ergebnisse zurück.
`ADSIPROP_TIME_LIMIT` Wert: 0x3 Gibt das Zeitlimit in Sekunden an, das der Server bei einer Suche beachten soll. Ein Nullwert gibt an, dass keine Zeitliche Begrenzung festgelegt wird. Wenn das Zeitlimit erreicht ist, beendet der Server die Suche und gibt die bis zu diesem Zeitpunkt gesammelten Ergebnisse zurück.
`ADSIPROP_ATTRIBTYPES_ONLY` Wert: 0x4 Gibt an, dass die Suche nur den Namen der Attribute abrufen soll, denen Werte zugewiesen wurden.
`ADSIPROP_SEARCH_SCOPE` Wert: 0x5 Gibt den Suchbereich an, der vom Server beobachtet werden soll. Weitere Informationen zu den entsprechenden Einstellungen finden Sie in der ADS_SCOPEENUM-Enumeration .
`ADSIPROP_TIMEOUT` Wert: 0x6 Gibt das Zeitlimit in Sekunden an, das ein Client wartet, bis der Server das Ergebnis zurückgibt.
`ADSIPROP_PAGESIZE` Wert: 0x7 Gibt die Seitengröße in einer Seitensuche an. Für jede Anforderung durch den Client gibt der Server höchstens die Anzahl der Objekte zurück, die durch die Seitengröße festgelegt werden.
`ADSIPROP_PAGED_TIME_LIMIT` Wert: 0x8 Gibt das Zeitlimit in Sekunden an, das der Server beachten soll, um eine Seite mit Ergebnissen zu durchsuchen. Dies steht im Gegensatz zu dem Zeitlimit für die gesamte Suche.
`ADSIPROP_CHASE_REFERRALS` Wert: 0x9 Gibt an, dass Empfehlungen verfolgt werden können. Wenn die Stammsuche nicht im Namenskontext des Servers angegeben ist oder wenn die Suchergebnisse einen Namenskontext kreuzen (z. B. wenn Sie untergeordnete Domänen haben und in der übergeordneten Domäne suchen), sendet der Server eine Empfehlungsnachricht an den Client, die der Client ignorieren oder verfolgen kann. Standardmäßig ist diese Option auf ADS_CHASE_REFERRALS_EXTERNAL festgelegt. Weitere Informationen zur Verfolgung von Empfehlungen finden Sie unter ADS_CHASE_REFERRALS_ENUM.
`ADSIPROP_SORT_ON` Wert: 0xa Gibt an, dass der Server das Resultset sortiert. Verwenden Sie die ADS_SORTKEY-Struktur , um die Sortierschlüssel anzugeben.
`ADSIPROP_CACHE_RESULTS` Wert: 0xb Gibt an, ob das Ergebnis clientseitig zwischengespeichert werden soll. Standardmäßig speichert ADSI das Resultset zwischen. Das Deaktivieren dieser Option kann für große Resultsets wünschenswert sein.
`ADSIPROP_ADSIFLAG` Wert: 0xc Ermöglicht dem OLEDB-Client, Bindungsflags anzugeben, die bei der Bindung an den Server verwendet werden sollen. Gültige Werte sind die von ADsOpenObject zulässigen Werte. Der Zugriff erfolgt über ADO-Skripts mithilfe des Eigenschaftennamens "ADSI Flag".

Hinweise

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 Ihrer VBScript-Anwendung festzulegen. Um die symbolischen Konstanten als bewährte Programmierpraxis zu verwenden, schreiben Sie explizite Deklarationen solcher Konstanten, wie hier in Ihrer VBScript-Anwendung geschehen.