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