IDirectorySearch

The IDirectorySearch interface provides clients written in C and C++ with vtable access to methods for querying underlying directory service data.

When to Implement

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.

When to Use

Call the methods of IDirectorySearch from a non-Automation client to query the directory service and to examine the query result.

Methods in Vtable Order

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.

See Also

Using Directory Service Queries