Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

TranslateCharsetInfo function (wingdi.h)

Translates character set information and sets all members of a destination structure to appropriate values.

Syntax

BOOL TranslateCharsetInfo(
 [in, out] DWORD *lpSrc,
 [out] LPCHARSETINFO lpCs,
 [in] DWORD dwFlags
);

Parameters

[in, out] lpSrc

Pointer to the fsCsb member of a FONTSIGNATURE structure if dwFlags is set to TCI_SRCFONTSIG. Otherwise, this parameter is set to a DWORD value indicating the source.

[out] lpCs

Pointer to a CHARSETINFO structure that receives the translated character set information.

[in] dwFlags

Flags specifying how to perform the translation. This parameter can be one of the following values.

Value Meaning
TCI_SRCCHARSET
Source contains the character set value in the low word, and 0 in the high word.
TCI_SRCCODEPAGE
Source is a code page identifier in the low word and 0 in the high word.
TCI_SRCFONTSIG
Source is the code page bitfield portion of a FONTSIGNATURE structure. On input this should have only one Windows code-page bit set, either for an ANSI code page value or for a common ANSI and OEM value (for OEM values, bits 32-63 must be clear). On output, this has only one bit set.

If the TCI_SRCFONTSIG value is given, the lpSrc parameter must be the address of the code-page bitfield. If any other TCI_ value is given, the lpSrc parameter must be a value not an address.

TCI_SRCLOCALE
Windows 2000: Source is the locale identifier (LCID) or language identifier of the keyboard layout. If it is a language identifier, the value is in the low word.

Return value

Returns a nonzero value if successful, or 0 otherwise. To get extended error information, the application can call GetLastError.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

CHARSETINFO

FONTSIGNATURE

Unicode and Character Set Functions

Unicode and Character Sets


Feedback

Was this page helpful?

Additional resources