ADS_PREFERENCES_ENUM enumeration (iads.h)

The ADS_PREFERENCES_ENUM enumeration specifies the query preferences of the OLE DB provider for 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;

Constants

ADSIPROP_ASYNCHRONOUS Value: 0 Requests an asynchronous search.
ADSIPROP_DEREF_ALIASES Value: 0x1 Specifies that aliases of found objects are to be resolved. Use ADS_DEREFENUM to specify how to perform this operation.
ADSIPROP_SIZE_LIMIT Value: 0x2 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 Value: 0x3 Specifies the time limit, in seconds, that the server should observe in a search. A zero value indicates that no time limit restriction is imposed. When the time limit is reached, the server stops searching and returns results accumulated to that point.
ADSIPROP_ATTRIBTYPES_ONLY Value: 0x4 Indicates that the search should obtain only the name of attributes to which values have been assigned.
ADSIPROP_SEARCH_SCOPE Value: 0x5 Specifies the search scope that should be observed by the server. For more information about the appropriate settings, see the ADS_SCOPEENUM enumeration.
ADSIPROP_TIMEOUT Value: 0x6 Specifies the time limit, in seconds, that a client will wait for the server to return the result.
ADSIPROP_PAGESIZE Value: 0x7 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 Value: 0x8 Specifies the time limit, in seconds, that the server should observe to search a page of results; this is opposed to the time limit for the entire search.
ADSIPROP_CHASE_REFERRALS Value: 0x9 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 about referrals chasing, see ADS_CHASE_REFERRALS_ENUM.
ADSIPROP_SORT_ON Value: 0xa Specifies that the server sorts the result set. Use the ADS_SORTKEY structure to specify the sort keys.
ADSIPROP_CACHE_RESULTS Value: 0xb 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_ADSIFLAG Value: 0xc Allows the OLEDB client to specify bind flags to use when binding to the server. Valid values are those allowed by ADsOpenObject. It is accessed from ADO scripts using the property name "ADSI Flag."

Remarks

Because VBScript cannot read data from a type library, VBScript applications do not recognize the symbolic constants as defined above. Instead, use the numerical constants to set the appropriate flags in your VBScript application. To use the symbolic constants, as a good programming practice, write explicit declarations of such constants, as done here, in your VBScript application.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	iads.h

See also

ADSI Enumerations

ADS_CHASE_REFERRALS_ENUM

ADS_DEREFENUM

ADS_SCOPEENUM

ADS_SORTKEY