Platform SDK: Active Directory, ADSI, and Directory Services

ADS_PREFERENCES_ENUM

The ADS_PREFERENCES enumeration specifies the query preferences of the OLE DB provider for ADSI.

typedef enum {
  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_BINDFLAG          = 0xc,
  ADSIPROP_USEBINDFLAG       = 0xd
  } ADS_PREFERENCES_ENUM;

Elements

ADSIPROP_ASYNCHRONOUS
Requests an asynchronous search.
ADSIPROP_DEREF_ALIASES
Specifies that aliases of found objects are to be resolved. Use ADS_DEREFENUM to specify how this should be done.
ADSIPROP_SIZE_LIMIT
Specifies the size limit that the server should observe in a search. The size limit is the maximum number of returned objects. A zero value indicates that no size limit is imposed. The server stops searching once the size limit is reached and returns the results accumulated up to that point.
ADSIPROP_TIME_LIMIT
Specifies the time limit (in seconds) that the server should observe in a search. A zero value means that no time limit restriction is imposed. When the time limit is reached, the server stops searching and returns whatever results it has accumulated up to that point.
ADSIPROP_ATTRIBTYPES_ONLY
Indicates that the search should obtain only the name of attributes to which values have been assigned.
ADSIPROP_SEARCH_SCOPE
Specifies the search scope that should be observed by the server. For the appropriate settings, see the ADS_SCOPEENUM enumeration.
ADSIPROP_TIMEOUT
Specifies the time limit (in seconds) that a client is willing to wait for the server to return the result.
ADSIPROP_PAGESIZE
Specifies the page size in a paged search. For each request by the client, the server returns, at most, the number of objects as set by the page size.
ADSIPROP_PAGED_TIME_LIMIT
Specifies the time limit (in seconds) that the server should observe to search a page of results (as opposed to the time limit for the entire search).
ADSIPROP_CHASE_REFERRALS
Specifies that referrals may be chased. If the root search is not specified in the naming context of the server or when the search results cross a naming context (for example, when you have child domains and search in the parent domain), the server sends a referral message to the client which the client can choose to ignore or chase. By default, this option is set to ADS_CHASE_REFERRALS_EXTERNAL. For more information on referrals chasing, see ADS_CHASE_REFERRALS_ENUM.
ADSIPROP_SORT_ON
Specifies that the server sorts the result set. Use the ADS_SORTKEY structure to specify the sort keys.
ADSIPROP_CACHE_RESULTS
Specifies if the result should be cached on the client side. By default, ADSI caches the result set. Turning off this option may be more desirable for large result sets.
ADSIPROP_BINDFLAG
ADSIPROP_USEBINDFLAG

Remarks

Note  Because VBScript cannot read information from a type library, VBScript applications do not understand the symbolic constants as defined above. You should use the numerical constants instead to set the appropriate flags in your VBScript applications. If you want to use the symbolic constants as a good programming practice, you should make explicit declarations of such constants, as done here, in your VBScript applications.

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with DSClient).
  Windows 95/98: Requires Windows 95 or later (with DSClient).
  Header: Declared in Iads.h.

See Also

ADSI Enumerations, ADS_CHASE_REFERRALS_ENUM, ADS_DEREFENUM, ADS_SCOPEENUM, ADS_SORTKEY