AddMRUStringW.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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

Exported by ordinal only. Use GetProcAddress(3w) to obtain a pointer to the function.

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

Debug channel "commctrl".