IRTCUserSearchQuery::SearchPreference
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
Note
This method is unsupported in Windows Embedded CE 6.0.
This method sets or gets the value currently assigned to a specified search preference. The preference is applied when the application calls the IRTCUserSearch::ExecuteSearch with the associated query object.
Syntax
HRESULT put_SearchPreference(
RTC_USER_SEARCH_PREFERENCE enPreference,
long lValue
);
HRESULT get_SearchPreference(
RTC_USER_SEARCH_PREFERENCE enPreference,
long* plValue
);
Parameters
- enPreference
[in] An RTC_USER_SEARCH_PREFERENCE enumeration value that specifies the search preference.
- lValue, plValue
[in, out] The numeric value for the preference. For example, if enPreference is set to RTCUSP_TIME_LIMIT, the associated time limit value can be set to 30 seconds by specifying a value of 30 in this parameter.
Return Value
This method can return an RTC_E_ constant. The following table shows additional possible return values.
| Value | Meaning |
|---|---|
E_INVALIDARG |
The enPreference parameter is not a valid enumeration value or the lValue parameter exceeds the allowed limit. |
E_POINTER |
The plValue parameter is not a valid pointer. |
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |
See Also
Reference
IRTCUserSearchQuery
IRTCUserSearch::ExecuteSearch
RTC_USER_SEARCH_PREFERENCE