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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.