PROPENUMPROCW callback function (winuser.h)
An application-defined callback function used with the EnumProps function. The function receives property entries from a window's property list. The PROPENUMPROC type defines a pointer to this callback function. PropEnumProc is a placeholder for the application-defined function name.
Syntax
PROPENUMPROCW Propenumprocw;
BOOL Propenumprocw(
HWND unnamedParam1,
LPCWSTR unnamedParam2,
HANDLE unnamedParam3
)
{...}
Parameters
unnamedParam1
Type: HWND
A handle to the window whose property list is being enumerated.
unnamedParam2
Type: LPCTSTR
The string component of a property list entry. This is the string that was specified, along with a data handle, when the property was added to the window's property list via a call to the SetProp function.
unnamedParam3
Type: HANDLE
A handle to the data. This handle is the data component of a property list entry.
Return value
Type: BOOL
Return TRUE to continue the property list enumeration.
Return FALSE to stop the property list enumeration.
Remarks
The following restrictions apply to this callback function:
- The callback function can call the RemoveProp function. However, RemoveProp can remove only the property passed to the callback function through the callback function's parameters.
- The callback function should not attempt to add properties.
Note
The winuser.h header defines PROPENUMPROC as an alias that automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that is not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | winuser.h (include Windows.h) |
See also
Conceptual
Reference