IMLangCodePages::GetCharCodePages

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method retrieves the set of code pages to which the given Unicode character belongs.

Syntax

HRESULT GetCharCodePages( 
  WCHAR chSrc,
  DWORD* pdwCodePages
);

Parameters

• chSrc
  [in] Source Unicode character for which the client wants a set of code pages.

• pdwCodePages
  [out] Pointer to an unsigned long integer where the set of code pages is returned that contains the source Unicode character specified by the chSrc parameter.

Return Value

Returns S_OK if successful or an error value otherwise.

Remarks

For more information about sets of code pages, see IMLangCodePages.

A Unicode character can belong to multiple code pages. For example, the Unicode character U+5B57 belongs to the Japanese (932), Korean (949), Simplified Chinese (936), and Traditional Chinese (950) code pages. This method determines to which code pages the given Unicode character belongs. For the character U+5B57, four bits — those bits corresponding to the code pages listed above — in the pdwCodePages parameter would be set to 1. The actual code page identifier values corresponding to the set pointed to by the pdwCodePages parameter can then be retrieved by the IMLangCodePages::CodePagesToCodePage method.

Requirements