Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The IRTCUserSearchResultsEvent interface contains details of the user search. When a search returns from IRTCUserSearch::ExecuteSearch, the RTCE_USERSEARCH event is fired, and the IRTCUserSearchResultsEvent interface is available by calling QueryInterface on the event object.
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_USERSEARCH, the method's pEvent parameter is an IDispatch pointer for the IRTCUserSearchResultsEvent interface.
Note You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCEF_USERSEARCH event to enable reception of user search result events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.
No results will be returned if the status code retrieved with get_StatusCode indicated failure.
Methods in Vtable Order
The IRTCUserSearchResultsEvent interface inherits the methods of the standard COM interface IUnknown.
In addition, IRTCUserSearchResultsEvent defines the following methods.
| Method | Description |
|---|---|
| EnumerateResults | Returns an enumeration of the results from the user search. If there are no results, an empty enumeration is returned. |
| get_Results | Gets a collection of the results from the user search. If there are no results, an empty collection is returned. |
| get_Profile | Gets the IRTCProfile2 interface for the profile used to execute the search. |
| get_Query | Gets the query object submitted for the search. |
| get_Cookie | Gets the cookie supplied to the IRTCUserSearch::ExecuteSearch operation that has completed. |
| get_StatusCode | Gets the result code of the IRTCUserSearch::ExecuteSearch operation that has completed. |
| get_MoreAvailable | Gets a boolean value that indicates whether or not possible unreturned results exist on the server for the IRTCUserSearch::ExecuteSearch operation that has completed. |
Requirements
Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCEnumSearchResultEvent is defined as D8C8C3CD-7FAC-4088-81C5-C24CBC0938E3.