The callback function must not yield control or do anything that might yield control to other tasks.| BOOL CALLBACK EnumPropProc(hwnd, lpString, hData) | |||||
| HWND hwnd; | /* handle of window with property | */ | |||
| LPCSTR lpString; | /* property string or atom | */ | |||
| HANDLE hData; | /* data handle | */ | |||
The EnumPropProc function is an application-defined callback function that receives a window's property data as a result of a call to the EnumProps function.
hwnd
Identifies the handle of the window that contains the property list.
lpString
Points to the null-terminated string associated with the data handle identified by the hData parameter. The application specified the string and data handle in a previous call to the SetProp function. If the application passed an atom instead of a string to the SetProp function, the lpString parameter contains the atom in the low-order word, and zero in the high-order word.
hData
Identifies the data handle.
The callback function should return a TRUE to continue enumeration; it should return FALSE to stop enumeration.
The following restrictions apply to the callback function:
The callback function must not yield control or do anything that might yield control to other tasks.
The callback function can call the RemoveProp function. However, the RemoveProp function 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.
EnumPropProc is a placeholder for the application-supplied function name. The actual name must be exported by including it in an EXPORTS statement in the application's module-definition file.
EnumProps, RemoveProp, SetProp