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