Pengambilan Rentang Atribut

Atribut multinilai dapat memiliki hampir semua jumlah nilai. Dalam banyak kasus, mungkin menguntungkan, atau bahkan diperlukan, untuk membatasi rentang nilai yang diambil oleh kueri.

Pengambilan rentang melibatkan permintaan sejumlah nilai atribut terbatas dalam satu kueri. Jumlah nilai yang diminta harus kurang dari, atau sama dengan, jumlah maksimum nilai yang didukung oleh server. Untuk mengurangi berapa kali kueri harus menghubungi server, jumlah nilai yang diminta harus sedekat mungkin dengan maksimum ini. Untuk memungkinkan aplikasi bekerja dengan benar dengan semua server Windows, jumlah maksimum 1000 harus digunakan.

Penentu rentang untuk kueri properti memerlukan formulir berikut:

range=<low range>-<high range>

di mana "<rentang> rendah" adalah indeks berbasis nol dari nilai properti pertama yang diambil dan "<rentang> tinggi" adalah indeks berbasis nol dari nilai properti terakhir yang akan diambil. Nol digunakan untuk "<rentang> rendah" untuk menentukan entri pertama. Karakter kartubebas (*) dapat digunakan untuk "<rentang> tinggi" untuk menentukan semua entri yang tersisa.

Tabel berikut ini mencantumkan contoh penentu rentang.

Contoh	Deskripsi
range=0-*	Ambil semua nilai properti. Ini tunduk pada batas yang diberlakukan oleh server.
range=0-500	Ambil dari nilai ke-1 hingga ke-501 secara inklusif.
range=2-3	Ambil nilai ke-3 dan ke-4.
range=501-*	Ambil nilai ke-502 dan semua nilai yang tersisa. Ini tunduk pada batas yang diberlakukan oleh server.

 

Ada beberapa cara berbeda untuk mengambil rentang nilai properti. Metode IADs.GetInfoEx dapat digunakan dalam bahasa automasi atau C++. Metode IADs.GetInfoEx adalah metode pilihan untuk melakukan pengambilan rentang. Untuk informasi selengkapnya tentang menggunakan IADs.GetInfoEx untuk pengambilan rentang, lihat Menggunakan IAD::GetInfoEx untuk Pengambilan Rentang.

Jika bahasa automasi digunakan, Objek Direktori ActiveX (ADO) dapat digunakan untuk mengambil rentang nilai properti. Untuk informasi selengkapnya tentang menggunakan ADO untuk pengambilan rentang, lihat Menggunakan ADO untuk Pengambilan Rentang.

Jika C++ digunakan, antarmuka IDirectorySearch dan IDirectoryObject dapat digunakan untuk mengambil rentang nilai properti. Untuk informasi selengkapnya tentang menggunakan IDirectorySearch dan IDirectoryObject untuk pengambilan rentang, lihat Menggunakan IDirectorySearch dan IDirectoryObject untuk Pengambilan Rentang. Jenis pengambilan ini harus dilakukan pada kueri dengan jenis cakupan Basis (ADS_SCOPE_BASE).