ISearchQueryHelper::put_QueryWhereRestrictions method

Sets the restrictions appended to a query in WHERE clauses.

Syntax

HRESULT put_QueryWhereRestrictions(
  LPCWSTR pszRestrictions
);

Parameters

pszRestrictions

Type: LPCWSTR

Pointer to a comma-delimited null-terminated Unicode string that specifies one or more query restrictions appended to the query in generated WHERE clause.

Return Value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

pszRestrictions must be a valid WHERE clause for Windows Search SQL (without the WHERE keyword).

When you create pszRestrictions with multiple restrictions, additional "WHERE" clauses concatenated to the first must start with "AND" or "OR". For example: "and contains(*, 'qqq')"

The DSearch code sample, available on Code Gallery and the Windows 7 SDK, demonstrates how to create a class for a static console application to query Windows Search using the Microsoft.Search.Interop assembly for ISearchQueryHelper.

Requirements

   
Minimum supported client Windows XP with SP2, Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 with SP1 [desktop apps only]
Target Platform Windows
Header searchapi.h
Redistributable Windows Desktop Search (WDS) 3.0

See Also

ISearchQueryHelper

ISearchQueryHelper::get_QueryWhereRestrictions

Querying the Index Programmatically

Querying the Index with Windows Search SQL Syntax