IDirectorySearch interface

The IDirectorySearch interface is a pure COM interface that provides a low overhead method that non-Automation clients can use to perform queries in the underlying directory.

Of the ADSI system-supplied providers, only the LDAP provider supports this interface.


The IDirectorySearch interface has these methods.

Method Description
IDirectorySearch::AbandonSearch The IDirectorySearch::AbandonSearch method abandons a search initiated by an earlier call to the ExecuteSearch method.
IDirectorySearch::CloseSearchHandle The IDirectorySearch::CloseSearchHandle method closes the handle to a search result and frees the associated memory.
IDirectorySearch::ExecuteSearch The IDirectorySearch::ExecuteSearch method executes a search and passes the results to the caller.
IDirectorySearch::FreeColumn The IDirectorySearch::FreeColumn method releases memory that the IDirectorySearch::GetColumn method allocated for data for the column.
IDirectorySearch::GetColumn The IDirectorySearch::GetColumn method gets data from a named column of the search result.
IDirectorySearch::GetFirstRow The GetFirstRow method gets the first row of a search result. This method will issue or reissue a new search, even if this method has been called before.
IDirectorySearch::GetNextColumnName The IDirectorySearch::GetNextColumnName method gets the name of the next column in the search result that contains data.
IDirectorySearch::GetNextRow Gets the next row of the search result.
IDirectorySearch::GetPreviousRow The IDirectorySearch::GetPreviousRow method gets the previous row of the search result. If the provider does not provide cursor support, it should return E_NOTIMPL.
IDirectorySearch::SetSearchPreference Specifies a search preference for obtaining data in a subsequent search.


Minimum supported client Windows Vista
Minimum supported server Windows Server 2008
Target Platform Windows
Header iads.h