Recuperação de intervalo de atributos
Um atributo de valores múltiplos pode ter quase qualquer número de valores. Em muitos casos, pode ser vantajoso, ou mesmo necessário, limitar o intervalo de valores que são recuperados por uma consulta.
A recuperação de intervalo envolve a solicitação de um número limitado de valores de atributo em uma única consulta. O número de valores solicitados deve ser menor ou igual ao número máximo de valores suportados pelo servidor. Para reduzir o número de vezes que a consulta deve entrar em contato com o servidor, o número de valores solicitados deve ser o mais próximo possível desse máximo. Para permitir que um aplicativo funcione corretamente com todos os servidores Windows, um número máximo de 1000 deve ser usado.
Os especificadores de intervalo para uma consulta de propriedade exigem o seguinte formulário:
range=<low range>-<high range>
onde "intervalo> baixo" é o índice baseado em zero do primeiro valor de propriedade a ser recuperado e "intervalo> alto"<< é o índice baseado em zero do último valor de propriedade a ser recuperado. Zero é usado para "intervalo> baixo"< para especificar a primeira entrada. O caractere curinga (*) pode ser usado para "intervalo> alto"< para especificar todas as entradas restantes.
A tabela a seguir lista exemplos de especificadores de intervalo.
| Exemplo | Descrição |
|---|---|
| intervalo=0-* | Recupere todos os valores de propriedade. Isso está sujeito a limites impostos pelo servidor. |
| intervalo=0-500 | Recupere do 1º ao 501º valores inclusive. |
| intervalo=2-3 | Recupere 3º e 4º valores. |
| intervalo=501-* | Recupere o 502º e todos os valores restantes. Isso está sujeito a limites impostos pelo servidor. |
Há várias maneiras diferentes de recuperar um intervalo de valores de propriedade. O método IADs.GetInfoEx pode ser usado em uma linguagem de automação ou C++. O método IADs.GetInfoEx é o método preferencial de execução de recuperação de intervalo. Para obter mais informações sobre como usar IADs.GetInfoEx para recuperação de intervalo, consulte Usando IADs::GetInfoEx para recuperação de intervalo.
Se uma linguagem de automação for usada, o ActiveX Directory Objects (ADO) poderá ser usado para recuperar um intervalo de valores de propriedade. Para obter mais informações sobre como usar o ADO para recuperação de intervalo, consulte Usando o ADO para recuperação de intervalo.
Se C++ for usado, as interfaces IDirectorySearch e IDirectoryObject poderão ser usadas para recuperar um intervalo de valores de propriedade. Para obter mais informações sobre como usar IDirectorySearch e IDirectoryObject para recuperação de intervalo, consulte Usando IDirectorySearch e IDirectoryObject para recuperação de intervalo. Esse tipo de recuperação deve ser feito em consultas com um tipo de escopo de Base (ADS_SCOPE_BASE).