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. |
See Also