EnumMRUListW 函数

[此函数通过 Windows XP 与 Service Pack 2 (SP2) 和 Windows Server 2003 提供。 它在后续版本的 Windows 中可能已更改或不可用。 ]

枚举最近使用 (MRU) 列表的内容。 (可选)从 枚举中检索项。

语法

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

parameters

hMRU [in]

类型: HANDLE

创建列表时获取的 MRU 列表的句柄。

nItem [in]

类型: int

要返回的项。 如果此值小于 0,则函数返回 MRU 列表中的项数。

lpData [out]

类型: void*

指向接收 nItem 中请求的项的缓冲区的指针。 如果 nItem 小于 0,则此缓冲区的内容保持不变。

uLen [in]

类型: UINT

缓冲区的大小,包括终止 null 字符。 如果 MRU 列表是使用 MRU_BINARY 标志创建的,则这是以字节为单位的大小。 否则,它是以字符为单位的大小。

返回值

类型: int

返回以下值之一。

  • 如果 nItem 小于 0,则返回枚举中的项数。
  • 如果发生错误,则返回 -1。
  • 否则, 返回 lpData 中返回的字符串的大小,包括终止 null 字符。 如果 MRU 列表是使用 MRU_BINARY 标志创建的,则这是以字节为单位的大小。 否则,它是以字符为单位的大小。

备注

此函数不包括在公共标头或库中。 可以通过 GetProcAddress 访问它,也可以按序号( EnumMRUListW 为 403)从 comctl32.dll 中提取它。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
DLL
Comctl32.dll (5.0 或更高版本)
Unicode 和 ANSI 名称
EnumMRUListW (Unicode)

另请参阅

CreateMRUListW

MRUINFO