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

# AddMRUStringW(3w)

## NAME

**AddMRUStringW** (COMCTL32.401)

## SYNOPSIS

INT AddMRUStringW\
  (\
   HANDLE  *hList*,\
   LPCWSTR *lpszString*\
  )

## DESCRIPTION

Add an item to an **MRU** string list.

## PARAMS

*hList* **\[In\]**  Handle to list.

*lpszString* **\[In\]**  The string to add.

## RETURNS

**Success:** The number corresponding to the registry name where the string has been stored (**0** maps to **'a'**, **1** to **'b'** and so on).

**Failure:** **-1**, if *hList* is **NULL** or memory allocation fails. If *lpszString* is invalid, the function returns **0**, and **[GetLastError(3w)](/GetLastError/3w.md)** returns **ERROR\_INVALID\_PARAMETER**. The last error value is set only in this case.

## NOTES

**-**If *lpszString* exists in the list already, it is moved to the top of the **MRU** list (it is not duplicated).

**-**If the list is full the least recently used list entry is replaced with *lpszString*.

**-**If this function returns **0** you should check the last error value to ensure the call really succeeded.

## IMPLEMENTATION

Not declared in a Wine header. The function is either undocumented, or missing from Wine.

Implemented in **"dlls/comctl32/comctl32undoc.c"**.

Debug channel **"commctrl"**.