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.
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