Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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

Syntax 

BOOL GetCPInfo(
  UINT 
CodePage, 
  LPCPINFO 
lpCPInfo 
);

Parameters

CodePage

[in] Value that 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. The following table shows the values this parameter can take.

Value Description

CP_ACP

Use the system default ANSI code page.

CP_MACCP

Not supported.

CP_OEMCP

Use the system default OEM code page.

CP_UTF7

Use the UTF-7 code page.

CP_UTF8

Use the UTF-8 code page.
lpCPInfo

[out] Pointer to a CPINFOstructure that receives information about the code page.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call the GetLastErrorfunction.

Remarks

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

For more information about code pages, see Code Pages.

Requirements

Header winnls.h
Library Coreloc.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

GetACP
GetOEMCP
CPINFO

Concepts

Code Pages