PropEnumProcEx
A version of this page is also available for
4/8/2010
This function receives property entries from the property list for a window. PropEnumProcEx is an application-defined callback function used with the EnumPropsEx function.
Syntax
BOOL CALLBACK PropEnumProcEx(
HWND hwnd,
LPTSTR lpszString,
HANDLE hData,
ULONG_PTR dwData
);
Parameters
- hwnd
[in] Handle to the window for which you are enumerating properties.
- lpszString
[in] Pointer to a null-terminated string that contains the string component of the property list entry. The application specified this string, along with a data handle, when the application added the property to the property list for the window by calling the SetProp function.
- hData
[in] Handle to the data component of the property list entry.
- dwData
[in] Pointer to an unsigned long integer that contains application-defined data. The application specified this value as the lParam parameter when the application called EnumPropsEx to initiate the enumeration.
Return Value
Return TRUE to indicate that EnumPropsEx should continue enumerating entries in the property list. Return FALSE to indicate that EnumPropsEx should stop enumerating entries in the property list.
Remarks
The PROPENUMPROCEX type defines a pointer to this callback function. PropEnumProcEx is a placeholder for the application-defined function name.
The callback function must not yield control to other tasks and must not perform any actions that could yield control to other tasks. The callback function can call the RemoveProp function, but RemoveProp can remove only the property that EnumPropsEx passed to the callback function through the parameters of the callback function. The callback function should not attempt to add properties.
Requirements
| Header | windows.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |