1 out of 1 rated this helpful - Rate this topic

GetACP function

Applies to: desktop apps only

Retrieves the current Windows ANSI code page identifier for the operating system.

Caution  The ANSI API functions, for example, the ANSI version of TextOut, implicitly use GetACP to translate text to or from Unicode. For the Multilingual User Interface (MUI) edition of Windows, the system ACP might not cover all code points in the user's selected logon language identifier. For compatibility with this edition, your application should avoid calls that depend on GetACP either implicitly or explicitly, as this function can cause some locales to display text as question marks. Instead, the application should use the Unicode API functions directly, for example, the Unicode version of TextOut.

Syntax

UINT GetACP(void);

Parameters

This function has no parameters.

Return value

Returns the current Windows ANSI code page (ACP) identifier for the operating system. See Code Page Identifiers for a list of identifiers for Windows ANSI code pages and other code pages.

Remarks

The ANSI code pages can be different on different computers, or can be changed for a single computer, leading to data corruption. For the most consistent results, applications should use UTF-8 or UTF-16 when possible.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Winnls.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

National Language Support
National Language Support Functions
Code Page Identifiers
GetCPInfo
GetOEMCP

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Alternative to using unmanaged code

As an alternative to using this unmanaged API, use the managed System.TextInfo class, and the ANSICodePage property.

For more information on this property, see: http://msdn.microsoft.com/en-us/library/system.globalization.textinfo.ansicodepage(VS.71).aspx

vb.net syntax
<DllImport("kernel32.dll")> _
Public Shared Function GetACP() As Integer End Function
C# syntax
[DllImport("kernel32.dll")]
public static extern int GetACP();