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