Recuperação do intervalo de atributos
Um atributo com vários valores pode ter quase qualquer número de valores. Em muitos casos, pode ser vantajoso, ou até mesmo necessário, limitar o intervalo de valores 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 com suporte 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 estar 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>
em que "<>de intervalo baixo " é o índice baseado em zero do primeiro valor de propriedade a ser recuperado e"<>de alto intervalo " é o índice baseado em zero do último valor de propriedade a ser recuperado. Zero é usado para "<>de intervalo baixo " para especificar a primeira entrada. O caractere curinga (*) pode ser usado para "<>de alto intervalo " para especificar todas as entradas restantes.
A tabela a seguir lista exemplos de especificadores de intervalo.
| Exemplo | Descrição |
|---|---|
| range=0-* | Recupere todos os valores de propriedade. Isso está sujeito aos limites impostos pelo servidor. |
| range=0-500 | Recupere de 1º a 501º valores, inclusive. |
| range=2-3 | Recupere os valores 3º e 4º. |
| range=501-* | Recupere o 502º e todos os valores restantes. Isso está sujeito aos 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 em C++. O método IADs.GetInfoEx é o método preferencial para executar a recuperação de intervalo. Para obter mais informações sobre como usar IADs.GetInfoEx para recuperação de intervalo, consulte Usando IADs::GetInfoEx for Range Retrieval.
Se uma linguagem de automação for usada, o ADO (ActiveX Directory Objects) 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 parade Recuperação de Intervalo.
Se o C++ for usado, as interfacesIDirectorySearcheIDirectoryObject 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 Using IDirectorySearch and IDirectoryObject for Range Retrieval. Esse tipo de recuperação deve ser feito em consultas com um tipo de escopo de Base (ADS_SCOPE_BASE).