énumération ADS_PREFERENCES_ENUM (iads.h)

Article
08/24/2023

L’énumération ADS_PREFERENCES_ENUM spécifie les préférences de requête du fournisseur OLE DB pour 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` Valeur : 0 Demande une recherche asynchrone.
`ADSIPROP_DEREF_ALIASES` Valeur : 0x1 Spécifie que les alias des objets trouvés doivent être résolus. Utilisez ADS_DEREFENUM pour spécifier comment effectuer cette opération.
`ADSIPROP_SIZE_LIMIT` Valeur : 0x2 Spécifie la limite de taille que le serveur doit observer dans une recherche. La limite de taille est le nombre maximal d’objets retournés. Une valeur zéro indique qu’aucune limite de taille n’est imposée. Le serveur cesse de rechercher une fois la limite de taille atteinte et retourne les résultats accumulés jusqu’à ce point.
`ADSIPROP_TIME_LIMIT` Valeur : 0x3 Spécifie la limite de temps, en secondes, que le serveur doit observer dans une recherche. Une valeur zéro indique qu’aucune restriction de limite de temps n’est imposée. Lorsque la limite de temps est atteinte, le serveur cesse de rechercher et retourne les résultats accumulés jusqu’à ce point.
`ADSIPROP_ATTRIBTYPES_ONLY` Valeur : 0x4 Indique que la recherche doit obtenir uniquement le nom des attributs auxquels des valeurs ont été affectées.
`ADSIPROP_SEARCH_SCOPE` Valeur : 0x5 Spécifie l’étendue de recherche qui doit être observée par le serveur. Pour plus d’informations sur les paramètres appropriés, consultez l’énumération ADS_SCOPEENUM .
`ADSIPROP_TIMEOUT` Valeur : 0x6 Spécifie la limite de temps, en secondes, pendant laquelle un client attend que le serveur retourne le résultat.
`ADSIPROP_PAGESIZE` Valeur : 0x7 Spécifie la taille de page dans une recherche paginée. Pour chaque requête du client, le serveur retourne, au maximum, le nombre d’objets tel que défini par la taille de page.
`ADSIPROP_PAGED_TIME_LIMIT` Valeur : 0x8 Spécifie la limite de temps, en secondes, que le serveur doit observer pour rechercher une page de résultats ; cela s’oppose à la limite de temps pour l’ensemble de la recherche.
`ADSIPROP_CHASE_REFERRALS` Valeur : 0x9 Spécifie que les références peuvent être poursuivies. Si la recherche racine n’est pas spécifiée dans le contexte d’affectation de noms du serveur ou lorsque les résultats de la recherche croisent un contexte de nommage (par exemple, lorsque vous avez des domaines enfants et que vous effectuez une recherche dans le domaine parent), le serveur envoie un message de référence au client que le client peut choisir d’ignorer ou de poursuivre. Par défaut, cette option est définie sur ADS_CHASE_REFERRALS_EXTERNAL. Pour plus d’informations sur la poursuite des références, consultez ADS_CHASE_REFERRALS_ENUM.
`ADSIPROP_SORT_ON` Valeur : 0xa Spécifie que le serveur trie le jeu de résultats. Utilisez la structure ADS_SORTKEY pour spécifier les clés de tri.
`ADSIPROP_CACHE_RESULTS` Valeur : 0xb Spécifie si le résultat doit être mis en cache côté client. Par défaut, ADSI met en cache le jeu de résultats. La désactivation de cette option peut être plus souhaitable pour les jeux de résultats volumineux.
`ADSIPROP_ADSIFLAG` Valeur : 0xc Permet au client OLEDB de spécifier les indicateurs de liaison à utiliser lors de la liaison au serveur. Les valeurs valides sont celles autorisées par ADsOpenObject. Il est accessible à partir de scripts ADO à l’aide du nom de propriété « Indicateur ADSI ».

Remarques

Étant donné que VBScript ne peut pas lire les données d’une bibliothèque de types, les applications VBScript ne reconnaissent pas les constantes symboliques définies ci-dessus. Utilisez plutôt les constantes numériques pour définir les indicateurs appropriés dans votre application VBScript. Pour utiliser les constantes symboliques, comme bonne pratique de programmation, écrivez des déclarations explicites de telles constantes, comme cela est fait ici, dans votre application VBScript.