Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

Returns the default IInkRecognizerfor a known language, specified by a national language support (NLS) language code identifier (LCID). This function only accepts the default argument for LCID (which is 0) since Windows Mobile Classic doesn’t support multiple recognizers.

For more information about LCIDs, see Language Identifiers and Locales.

Syntax 

HRESULT GetDefaultRecognizer (
  [in, defaultvalue(0)] long lcid,
  [out, retval] IInkRecognizer **DefaultRecognizer
);

Parameters

lcid

Specifies the LCID locale identifier of the language for which you are retrieving the default recognizer. If lcidis 0, the method uses the user's locale setting to determine which default recognizer to retrieve. If the user has not specified a locale in Regional Options, the method uses the locale that was specified for the computer.

DefaultRecognizer

Returns the requested recognizer.

Return Value

HRESULT value Description

S_OK

Success.

E_POINTER

A parameter contained an invalid pointer.

E_INK_EXCEPTION

An exception occurred inside the method.

E_INVALIDARG

The flag is invalid.

E_UNEXPECTED

Unexpected parameter or property type.

Remarks

Each language can have a default recognizer. For example, a user can have a default recognizer for U.S. English and a default recognizer for French. If no locale is specified, this method returns the recognizer for the active input locale. To select the active input locale, in the Regional and Language Options in ControlPanel, on the Languages tab, users click Details, and then select the Default input language.

The default value of the lcidparameter is 0.

This method generates an error if the lcidparameter is not a known locale or if a recognizer is not installed for the requested locale.

GetDefaultRecognizerfirst checks if there is a matching recognizer for the user's input locale. If there is none, it checks if there is a matching recognizer for the current system locale.

For more information about NLS, see National Language Support (NLS).

Requirements

Header msinkaut.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile 6 Classic and later, Windows Mobile 6 Professional and later

See Also