Directory Services

IDirectorySearch

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.

Methods in Vtable Order

The IDirectorySearch interface inherits the methods of the standard COM interface IUnknown.

In addition, IDirectorySearch defines the following methods.

Method Description
SetSearchPreference Sets options for conducting a search.
ExecuteSearch Executes an individual search.
AbandonSearch Abandons a search already in process.
GetFirstRow Gets the first row of the search result.
GetNextRow Gets the next row of the search result.
GetPreviousRow Gets the previous row of the search result.
GetNextColumnName Gets the name of the next column of the search result.
GetColumn Gets the item in a specified column from the current row of the search result.
FreeColumn Frees the ADS_SEARCH_COLUMN structure created by the GetColumn method.
CloseSearchHandle Releases the search result from memory.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.