Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

EnumMRUListW function

[This function is available through Windows XP with Service Pack 2 (SP2) and Windows Server 2003. It might be altered or unavailable in subsequent versions of Windows. ]

Enumerates the contents of the most recently used (MRU) list. Optionally retrieves an item from the enumeration.

Syntax


int EnumMRUListW(
  _In_   HANDLE hMRU,
  _In_   int nItem,
  _Out_  void *lpData,
  _In_   UINT uLen
);

Parameters

hMRU [in]

Type: HANDLE

The handle of the MRU list, obtained when the list was created.

nItem [in]

Type: int

The item to return. If this value is less than 0, the function returns the number of items in the MRU list.

lpData [out]

Type: void*

A pointer to a buffer that receives the item requested in nItem. If nItem is less than 0, the contents of this buffer are unchanged.

uLen [in]

Type: UINT

The size of the buffer, including the terminating null character. If the MRU list was created with the MRU_BINARY flag, this is the size in bytes. Otherwise, it is the size in characters.

Return value

Type: int

Returns one of the following values.

  • Returns the number of items in the enumeration, if nItem is less than 0.
  • Returns -1 if an error occurred.
  • Otherwise, returns the size of the string returned in lpData, including the terminating null character. If the MRU list was created with the MRU_BINARY flag, this is the size in bytes. Otherwise, it is the size in characters.

Remarks

This function is not included in a public header or library. It can be accessed through GetProcAddress or extracted from comctl32.dll by its ordinal, which is 403 for EnumMRUListW.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

DLL

Comctl32.dll (version 5.0 or later)

Unicode and ANSI names

EnumMRUListW (Unicode)

See also

CreateMRUListW
MRUINFO

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.