ADS_PREFERENCES_ENUM enumeración (iads.h)

Artículo
03/05/2024

La enumeración ADS_PREFERENCES_ENUM especifica las preferencias de consulta del proveedor OLE DB para ADSI.

Syntax

typedef enum __MIDL___MIDL_itf_ads_0000_0000_0022 {
  ADSIPROP_ASYNCHRONOUS = 0,
  ADSIPROP_DEREF_ALIASES = 0x1,
  ADSIPROP_SIZE_LIMIT = 0x2,
  ADSIPROP_TIME_LIMIT = 0x3,
  ADSIPROP_ATTRIBTYPES_ONLY = 0x4,
  ADSIPROP_SEARCH_SCOPE = 0x5,
  ADSIPROP_TIMEOUT = 0x6,
  ADSIPROP_PAGESIZE = 0x7,
  ADSIPROP_PAGED_TIME_LIMIT = 0x8,
  ADSIPROP_CHASE_REFERRALS = 0x9,
  ADSIPROP_SORT_ON = 0xa,
  ADSIPROP_CACHE_RESULTS = 0xb,
  ADSIPROP_ADSIFLAG = 0xc
} ADS_PREFERENCES_ENUM;

Constantes


`ADSIPROP_ASYNCHRONOUS` Valor: 0 Solicita una búsqueda asincrónica.
`ADSIPROP_DEREF_ALIASES` Valor: 0x1 Especifica que se van a resolver los alias de los objetos encontrados. Use ADS_DEREFENUM para especificar cómo realizar esta operación.
`ADSIPROP_SIZE_LIMIT` Valor: 0x2 Especifica el límite de tamaño que el servidor debe observar en una búsqueda. El límite de tamaño es el número máximo de objetos devueltos. Un valor cero indica que no se impone ningún límite de tamaño. El servidor deja de buscar una vez alcanzado el límite de tamaño y devuelve los resultados acumulados hasta ese momento.
`ADSIPROP_TIME_LIMIT` Valor: 0x3 Especifica el límite de tiempo, en segundos, que el servidor debe observar en una búsqueda. Un valor cero indica que no se impone ninguna restricción de límite de tiempo. Cuando se alcanza el límite de tiempo, el servidor deja de buscar y devuelve los resultados acumulados hasta ese momento.
`ADSIPROP_ATTRIBTYPES_ONLY` Valor: 0x4 Indica que la búsqueda debe obtener solo el nombre de los atributos a los que se han asignado los valores.
`ADSIPROP_SEARCH_SCOPE` Valor: 0x5 Especifica el ámbito de búsqueda que debe observar el servidor. Para obtener más información sobre la configuración adecuada, vea la enumeración ADS_SCOPEENUM .
`ADSIPROP_TIMEOUT` Valor: 0x6 Especifica el límite de tiempo, en segundos, que un cliente esperará a que el servidor devuelva el resultado.
`ADSIPROP_PAGESIZE` Valor: 0x7 Especifica el tamaño de página en una búsqueda paginada. Para cada solicitud del cliente, el servidor devuelve, como máximo, el número de objetos establecido por el tamaño de página.
`ADSIPROP_PAGED_TIME_LIMIT` Valor: 0x8 Especifica el límite de tiempo, en segundos, que el servidor debe observar para buscar en una página de resultados; esto se opone al límite de tiempo para toda la búsqueda.
`ADSIPROP_CHASE_REFERRALS` Valor: 0x9 Especifica que se pueden perseguir las referencias. Si la búsqueda raíz no se especifica en el contexto de nomenclatura del servidor o cuando los resultados de la búsqueda cruzan un contexto de nomenclatura (por ejemplo, cuando tiene dominios secundarios y busca en el dominio primario), el servidor envía un mensaje de referencia al cliente que el cliente puede elegir omitir o perseguir. De forma predeterminada, esta opción se establece en ADS_CHASE_REFERRALS_EXTERNAL. Para obtener más información sobre el seguimiento de referencias, consulte ADS_CHASE_REFERRALS_ENUM.
`ADSIPROP_SORT_ON` Valor: 0xa Especifica que el servidor ordena el conjunto de resultados. Use la estructura ADS_SORTKEY para especificar las claves de ordenación.
`ADSIPROP_CACHE_RESULTS` Valor: 0xb Especifica si el resultado se debe almacenar en caché en el lado cliente. De forma predeterminada, ADSI almacena en caché el conjunto de resultados. Desactivar esta opción puede ser más deseable para grandes conjuntos de resultados.
`ADSIPROP_ADSIFLAG` Valor: 0xc Permite al cliente OLEDB especificar marcas de enlace que se usarán al enlazar con el servidor. Los valores válidos son los permitidos por ADsOpenObject. Se tiene acceso desde scripts de ADO mediante el nombre de propiedad "ADSI Flag".

Comentarios

Dado que VBScript no puede leer datos de una biblioteca de tipos, las aplicaciones vbScript no reconocen las constantes simbólicas como se ha definido anteriormente. En su lugar, use las constantes numéricas para establecer las marcas adecuadas en la aplicación VBScript. Para usar las constantes simbólicas, como práctica de programación recomendada, escriba declaraciones explícitas de estas constantes, como se hace aquí, en la aplicación VBScript.