IMultiRepositorySearcher
A container for search objects that lets you search in all of the specified repositories simultaneously.
|
|
Caution: This container is optimized for shared use. Therefore, it is strongly recommended that you create only one IMultiRepositorySearcher and reuse it rather than creating different IMultiRepositorySearcher instances for different search queries and sets of repositories. |
Methods
MakeMultiSearchObject
Creates a search object that uses multiple repositories at once.
Syntax
HRESULT MakeMultiSearchObject(
[in] BSTR rel_query,
[in] SAFEARRAY(IDispatch) psaSeachers,
[out, retval] IObservable** search_object
);
Parameters
| Name | Type | Meaning |
|---|---|---|
|
rel_query |
BSTR |
Search query. |
| psaSeachers |
SAFEARRAY(IDispatch) |
Searcher interfaces for the repositories you want to search in. |
| search_object |
Interface that provides search functionality. |
IMultiRepositorySearcherFactory
Creates an instance of IMultiRepositorySearcher.
CreateMultiRepositorySearcher
Creates the IMultiRepositorySearcher.
Syntax
HRESULT CreateMultiRepositorySearcher(
[in] VARIANT eventory_xml,
[out, retval] IMultiRepositorySearcher** rep_searcher
);
Parameters
| Name | Type | Meaning |
|---|---|---|
|
eventory_xml |
VARIANT |
String representation of the log knowledge base to use with the multi-repository searches. To use the fallback knowledge base, specify null. |
|
rep_searcher |
The searcher interface capable of working with multiple repositories at once. |
IObservable
Defines a provider for push-based notification.
Method
Subscribe
Syntax
HRESULT Subscribe(
[in] IObserver* observer,
[out] ICookie** cookie
);
Parameters
| Name | Type | Meaning |
|---|---|---|
|
observer |
Source of push-based notifications. | |
|
cookie |
ICookie** |
Keeps the search active while present. |
IObserver
Provides a mechanism for receiving push-based notifications. You need to create your own implementation of this interface.
Methods
OnDone
Notifies the observer that the provider has finished sending push-based notifications.
Syntax
void OnDone();
OnError
Notifies the observer that the provider has experienced an error condition.
Syntax
void OnError(
[in] HRESULT hr,
[in] BSTR description
);
Parameters
| Name | Type | Meaning |
|---|---|---|
|
hr |
HRESULT |
Operation result. |
|
description |
BSTR |
Additional information about the error. |
OnNext
Provides the observer with new data.
Syntax
void OnNext(
[in] IUnknown* data
);
Parameter
| Name | Type | Meaning |
|---|---|---|
|
data |
IUnknown* |
The current notification information. |