Attributbereichsabruf
Ein mehrwertiges Attribut kann über fast eine beliebige Anzahl von Werten verfügen. In vielen Fällen kann es vorteilhaft oder sogar notwendig sein, den Von einer Abfrage abgerufenen Wertebereich einzuschränken.
Der Bereichsabruf umfasst das Anfordern einer begrenzten Anzahl von Attributwerten in einer einzelnen Abfrage. Die Anzahl der angeforderten Werte muss kleiner oder gleich der maximalen Anzahl von Werten sein, die vom Server unterstützt werden. Um zu reduzieren, wie oft die Abfrage den Server kontaktieren muss, sollte die Anzahl der angeforderten Werte so nahe wie möglich an diesem Maximum liegen. Damit eine Anwendung ordnungsgemäß mit allen Windows-Servern funktioniert, sollte eine maximale Anzahl von 1.000 verwendet werden.
Die Bereichsspezifizierer für eine Eigenschaftenabfrage erfordern die folgende Form:
range=<low range>-<high range>
wobei < "low > range" der nullbasierte Index des ersten abzurufenden Eigenschaftswerts und < "hoher > Bereich" der nullbasierte Index des letzten abzurufenden Eigenschaftswerts ist. 0 (null) wird für < "niedriger > Bereich" verwendet, um den ersten Eintrag anzugeben. Das Platzhalterzeichen ( * ) kann für "hoher Bereich" verwendet < > werden, um alle verbleibenden Einträge anzugeben.
In der folgenden Tabelle sind Beispiele für Bereichsspezifizierer aufgeführt.
| Beispiel | Beschreibung |
|---|---|
| range=0-* | Rufen Sie alle Eigenschaftswerte ab. Dies unterliegt den vom Server vorgegebenen Grenzwerten. |
| range=0-500 | Abrufen von Werten vom 1. bis zum 501. Inklusive. |
| range=2-3 | Ruft den dritten und den 4. Wert ab. |
| range=501-* | Rufen Sie den 502. und alle verbleibenden Werte ab. Dies unterliegt den vom Server vorgegebenen Grenzwerten. |
Es gibt verschiedene Möglichkeiten, einen Bereich von Eigenschaftswerten abzurufen. Die IADs.GetInfoEx-Methode kann entweder in einer Automatisierungssprache oder in C++ verwendet werden. Die IADs.GetInfoEx-Methode ist die bevorzugte Methode für den Bereichsabruf. Weitere Informationen zur Verwendung von IADs.GetInfoEx für den Bereichsabruf finden Sie unter Verwenden von IADs::GetInfoEx für den Bereichsabruf.
Wenn eine Automatisierungssprache verwendet wird, kann der ActiveX Directory Objects (ADO) verwendet werden, um einen Bereich von Eigenschaftswerten abzurufen. Weitere Informationen zur Verwendung von ADO für den Bereichsabruf finden Sie unter Verwenden von ADO für den Bereichsabruf.
Wenn C++ verwendet wird, können die Schnittstellen IDirectorySearch und IDirectoryObject verwendet werden, um einen Bereich von Eigenschaftswerten abzurufen. Weitere Informationen zur Verwendung von IDirectorySearch und IDirectoryObject für den Bereichsabruf finden Sie unter Verwenden von IDirectorySearch und IDirectoryObject für den Bereichsabruf. Diese Art des Abrufs sollte für Abfragen mit dem Bereichstyp Base (ADS_SCOPE_BASE) erfolgen.