PropEnumProcEx

小甲鱼

注：本文档由 CET-6-WPW 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

PropEnumProcEx 函数和 EnumPropsEx 函数一起使用的一个应用程序自定义的回调函数。该函数从窗口的属性列表中检索属性目录。PROPENUMPROCEX 类型定义一个指向该回调函数的指针，PropEnumProcEx 函数是应用程序自定义的函数名的占位符。


API 函数原型：

注释：_In_ 说明该参数是输入的。

BOOL CALLBACK PropEnumProcEx(
  _In_ HWND      hwnd,
  _In_ LPTSTR    lpszString,
  _In_ HANDLE    hData,
  _In_ ULONG_PTR dwData
);

参数解析：

参数	含义
hwnd	指定属性列表将被枚举的窗口的句柄
lpszString	1. 指向由属性列表目录组成的字符串 2. 当通过调用 SetProp 函数来将属性添加到窗口的属性列表中时，这个字符串将和数据句柄一起被指定
hData	指定数据的句柄，这个句柄是属性列表的目录的数据组成
dwData	1. 指定应用程序自定义的数据 2. 这个值被指定作为调用 EnumPropsEx 函数的 lParam 参数来发起枚举

返回值：

1. 如果函数返回 TRUE，则继续枚举属性列表；

2. 如果函数返回 FALSE，则停止枚举属性列表。


备注：

适用于该回调函数的的限制条件：

• 这个回调函数可以调用 RemoveProp 函数。然而，RemoveProp 函数只能移除通过该回调函数的参数传递给该回调函数的属性
• 该回调函数不应该尝试用于添加属性
  

需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winuser.h (包含于 Windows.h)
Unicode and ANSI names	PropEnumProcExW (Unicode) 和 PropEnumProcExA (ANSI)

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。