Recuperación del intervalo de atributos
Un atributo multivalor puede tener casi cualquier número de valores. En muchos casos, puede ser ventajoso o incluso necesario limitar el intervalo de valores recuperados por una consulta.
La recuperación del intervalo implica solicitar un número limitado de valores de atributo en una sola consulta. El número de valores solicitados debe ser menor o igual que el número máximo de valores admitidos por el servidor. Para reducir el número de veces que la consulta debe ponerse en contacto con el servidor, el número de valores solicitados debe estar lo más cerca posible de este máximo. Para permitir que una aplicación funcione correctamente con todos los servidores Windows, se debe usar un número máximo de 1000.
Los especificadores de intervalo para una consulta de propiedades requieren el siguiente formato:
range=<low range>-<high range>
donde "<rango> bajo" es el índice de base cero del primer valor de propiedad para recuperar y "<rango alto>" es el índice de base cero del último valor de propiedad que se va a recuperar. Cero se usa para "<rango> bajo" para especificar la primera entrada. El carácter comodín (*) se puede usar para "<rango alto>" para especificar todas las entradas restantes.
En la tabla siguiente se enumeran ejemplos de especificadores de rango.
| Ejemplo | Descripción |
|---|---|
| range=0-* | Recupere todos los valores de propiedad. Esto está sujeto a límites impuestos por el servidor. |
| range=0-500 | Recupere de 1 a 501 valores inclusive. |
| range=2-3 | Recupere los valores 3 y 4. |
| range=501-* | Recupere el 502nd y todos los valores restantes. Esto está sujeto a límites impuestos por el servidor. |
Hay varias maneras diferentes de recuperar un intervalo de valores de propiedad. El método IADs.GetInfoEx se puede usar en un lenguaje de automatización o en C++. El método IADs.GetInfoEx es el método preferido para realizar la recuperación de intervalos. Para obtener más información sobre el uso de IADs.GetInfoEx para la recuperación de rangos, vea Uso de IADs::GetInfoEx para la recuperación de rangos.
Si se usa un lenguaje de automatización, los objetos de ActiveX Directory (ADO) se pueden usar para recuperar un intervalo de valores de propiedad. Para obtener más información sobre el uso de ADO para la recuperación de rangos, consulte Uso de ADO para recuperación de intervalos.
Si se usa C++, las interfaces IDirectorySearch e IDirectoryObject se pueden usar para recuperar un intervalo de valores de propiedad. Para obtener más información sobre el uso de IDirectorySearch e IDirectoryObject para la recuperación de rangos, vea Using IDirectorySearch and IDirectoryObject for Range Retrieval. Este tipo de recuperación debe realizarse en consultas con un tipo de ámbito base (ADS_SCOPE_BASE).