---
name: "LCMapStringA"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/LCMapStringA"
---

# LCMapStringA(3w)

## NAME

**LCMapStringA** (KERNEL32.@)

## SYNOPSIS

INT LCMapStringA\
  (\
   LCID   *lcid*,\
   DWORD  *flags*,\
   LPCSTR *src*,\
   INT    *srclen*,\
   LPSTR  *dst*,\
   INT    *dstlen*\
  )

## DESCRIPTION

Map characters in a locale sensitive string.

## PARAMS

*lcid* **\[In\]**  **LCID** for the conversion.

*flags* **\[In\]**  Flags controlling the mapping (**LCMAP\_** constants from **"winnls.h"**).

*src* **\[In\]**  String to map.

*srclen* **\[In\]**  Length of *src* in chars, or **-1** if *src* is **NUL** terminated.

*dst* **\[Out\]**  Destination for mapped string.

*dstlen* **\[In\]**  Length of *dst* in characters.

## RETURNS

**Success:** The length of the mapped string in *dst*, including the **NUL** terminator.

**Failure:** **0.** Use **[GetLastError(3w)](/GetLastError/3w.md)** to determine the cause.

## IMPLEMENTATION

Declared in **"winnls.h"**.

Implemented in **"dlls/kernel32/locale.c"**.

Debug channel **"nls"**.