IRTCUserSearch::ExecuteSearch

This method executes a search using a user search query object. Search results are in the form of an RTCE_USERSEARCH event, returned asynchronously via the IRTCUserSearchResultsEvent interface.

HRESULT ExecuteSearch(
  IRTCUserSearchQuery* pQuery,
  IRTCProfile* pProfile,
  LONG_PTR lCookie
);

Parameters

  • pQuery
    [in] Pointer to the IRTCUserSearchQuery interface on a user search query object created with IRTCUserSearch::CreateQuery.
  • pProfile
    [in] Pointer to the IRTCProfile interface that is to be used to request the search.
  • lCookie
    [in] Pointer to an application-specified cookie that identifies this request. This value is generated and maintained by the application. It is also used to synchronize search requests and results indicated by an RTCE_USERSEARCH event. The application is responsible for ensuring the uniqueness of the cookie, as well as for releasing the cookie values from completed searches.

Return Values

This method can return an RTC_E_ constant.

Remarks

To execute a search, a profile that has PC-to-PC capabilities specified in the session type settings must be currently enabled. A profile can be created with the IRTCClientProvisioning::GetProfile method. It can then be enabled using the IRTCClientProvisioning::EnableProfile method.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.

See Also

Communications Service | IRTCClientProvisioning::GetProfile | IRTCClientProvisioning::EnableProfile | IRTCProfile | IRTCUserSearch::CreateQuery | IRTCUserSearchQuery | RTCUserSearchResultsEvent

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.