Result Caching

The ADS_SEARCHPREF_CACHE_RESULTS preference caches the result set on the client. Result caching enables an application to retain a retrieved result set and go through the retrieved rows again. It also enables cursor support (the IDirectorySearch::GetNextRow and IDirectorySearch::GetPreviousRow methods can be used to go up and down the result set).

Recommendations:

• Turn on caching if your application needs to go through the result set more than once without performing the search again on the server. If your application needs the result set and performing the search is expensive on the server (slow connection, large result set, or complex query), consider turning on caching.
• Turn on caching if you need cursor support.
• Turn off caching if your application needs to reduce memory requirements for caching a large result set at the client.

The default is for caching to be on.