GetCPInfoEx

[This is preliminary documentation and subject to change.]

The GetCPInfoEx function retrieves information about any valid installed or available code page.

BOOL GetCPInfoEx (
  UINT CodePage,         // code-page identifier
  DWORD dwFlags,         // flags (must be 0)
  LPCPINFOEX lpCPInfoEx  // address of structure for information
);
 

Parameters

CodePage

Specifies the code page about which information is to be retrieved. You can specify the code-page identifier for any installed or available code page, or you can specify one of the following predefined values.

Value	Meaning
CP_ACP	Use the system default ANSI code page.
CP_MACCP	Use the system default Macintosh code page.
CP_OEMCP	Use the system default OEM code page.

dwFlags

Reserved. Must be 0.

lpCPInfoEx

Pointer to a CPINFOEX structure that receives information about the code page.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

If the specified code page is not installed or not available, the GetCPInfoEx function sets the last-error value to ERROR_INVALID_PARAMETER.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98 or later.
  Windows CE: Unsupported.
  Header: Declared in winnls.h.
  Import Library: Use kernel32.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

National Language Support Overview, National Language Support Functions, GetACP, GetOEMCP, CPINFOEX