IixssoQuery::LocaleID property

Article
05/31/2018

[Indexing Service is no longer supported as of Windows XP and is unavailable for use as of Windows 8. Instead, use Windows Search for client side search and Microsoft Search Server Express for server side search.]

Retrieves or sets the language locale ID (LCID) to be used when executing the query. Otherwise, the system default LCID is used.

This property is read/write.

Syntax

HRESULT put_LocaleID(
  [in]          LONG val
);

HRESULT get_LocaleID(
  [out, retval] LONG *val
);

Property value

Specifies the LCID.

Remarks

This locale identifies the language to use to perform a query on existing indexes. Convert between language identifiers (strings) and LCIDs (constants) by using the ISOToLocaleID and LocaleIDToISO methods.

For Web clients requesting an Active Server Pages (ASP), browsers send an HTTP header ? HTTP_ACCEPT_LANGUAGE ? that specifies the locale to use in a query. This can be overridden with this LocaleID property. The U.S. English locale is 1033 (equivalent to the language code "en-us").

For Web clients using the ISAPI .idq files to define queries, assign the locale identifier string to CiLocale in the [Query] section of the query.idq file to override browser settings. See Valid Locale Identifiers for a list of language identifiers recognized by Indexing Services.

Examples

objQuery.LocaleID = 1033 ' EN-US locale code

Requirements


Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
End of client support	Windows 7
End of server support	Windows Server 2008 R2
DLL	Ixsso.dll

Share via