ISearchQueryHelper::put_QueryWhereRestrictions method (searchapi.h)

Article
02/22/2024

Sets the restrictions appended to a query in WHERE clauses.

Syntax

HRESULT put_QueryWhereRestrictions(
  [in] LPCWSTR pszRestrictions
);

Parameters

[in] 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')"

Checkout the DSearch code sample to see how to create a class for a static console application to query Windows Search using the Microsoft.Search.Interop assembly for ISearchQueryHelper.

Requirements

Requirement	Value
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