AddMRUStringW(3w)

AddMRUStringW3w

Usage

INT AddMRUStringW
(
HANDLE hList,
LPCWSTR lpszString
)

Overview

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) 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".

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.