The IDirectorySearch interface provides clients written in C and C++ with vtable access to methods for querying underlying directory service data.
ADSI providers who want to supply non-Automation clients with vtable methods for querying their directory services must implement IDirectorySearch on every generic directory service object. Implement this interface only on a custom directory service provider. For information on how this interface is implemented on system-supplied providers, see ADSI System Providers.
Call the methods of IDirectorySearch from a non-Automation client to query the directory service and to examine the query result.
| IUnknown Methods | Description |
|---|---|
| QueryInterface | Returns pointers to supported interfaces. |
| AddRef | Increments reference count. |
| Release | Decrements reference count. |
| IDirectorySearch Methods | Description |
|---|---|
| SetSearchPreference | Sets options for conducting a search |
| ExecuteSearch | Executes an individual search |
| AbandonSearch | Abandons search already under way. |
| 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 | |
| CloseSearchHandle | Releases the search result from memory. |
Using Directory Service Queries