Share via


GetCPInfo

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 CPINFO structure that receives information about the code page.

Return Value

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

Remarks

If the specified code page is not installed or not available, GetCPInfo sets 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