GetInternationalHRC

2.0

Retrieves the country, language, script direction, and international preferences from a recognition context HRC object.

int GetInternationalHRC( HRC hrc, UINT FAR * lpuCountry, LPSTR lpszLangCode, UINT FAR * lpfuFlags, UINT FAR * lpuDir )

Parameters
hrc

Handle to the HRC object.

lpuCountry

The country code, or NULL to ignore this value.

lpszLangCode

A buffer large enough to receive a three-letter string (that is, 4 bytes) identifying the language ("enu", "fra", etc.). If set to NULL, lpszLangCode is ignored.

lpfuFlags

A pointer to a flags value or NULL to ignore this value. If GetInternationalHRC returns SIH_ALLANSICHAR in lpfuFlags, it means that the user intends to use the entire ANSI character set. If this is the case, the application should ignore the value returned in lpszLangCode, since all the ANSI-based languages are undifferentiated.

lpuDir

Address of a value for the script direction, or NULL to ignore this value. This value specifies which primary and secondary writing directions are in use. Possible values are:

Constant	Description
SSH_RD	To right and down (English).
SSH_RU	To right and up.
SSH_LD	To left and down (Hebrew).
SSH_LU	To left and up.
SSH_DL	Down and to the left (Chinese).
SSH_DR	Down and to the right (Chinese).
SSH_UL	Up and to the left.
SSH_UR	Up and to the right.

Return Value
Returns HRCR_OK if successful; otherwise, returns one of the following negative values:

Constant	Description
HRCR_ERROR	Invalid parameter or other error.
HRCR_MEMERR	Insufficient memory.
HRCR_UNSUPPORTED	The recognizer does not support this function.