Prev Next

TranslateCharsetInfo info  Overview  Group

The TranslateCharsetInfo function translates based on the specified character set, code page, or font signature value, setting all members of the destination structure to appropriate values.

UINT TranslateCharsetInfo(

    DWORD FAR *lpSrc, 

    LPCHARSETINFO lpCs, 

    DWORD dwFlags 

   );

Parameters

lpSrc
Address or value as defined by the dwFlags parameter. If dwFlags is TCI_SRCFONTSIG, this parameter is the address of the fsCsb member of a FONTSIGNATURE structure. Otherwise, this parameter is a 32-bit value.
lpCs
Pointer to a CHARSETINFO structure that receives the translated character set information.
dwFlags
Translation flags. This parameter can be one of the following values:

Value

Meaning

TCI_SRCCHARSET

Source contains the character set value in the low word, and zero in the high word.

TCI_SRCCODEPAGE

Source is a code-page value in the low word and zero 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 will have only one bit set.

If the TCI_SRCFONTSIG value is given, the lpSrc parameter must be the address of the codepage bit field. If any other TCI_ value is given, the lpSrc parameter must be a value not an address.

Return Values

If the function succeeds, it returns a nonzero value.

If the function fails, it returns zero. To get extended error information, call GetLastError.

See Also

CHARSETINFO, FONTSIGNATURE