Partager via

PropEnumProcEx

  • Article

This function receives property entries from the property list for a window. PropEnumProcEx is an application-defined callback function used with the EnumPropsEx function.

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 Values

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

OS Versions: Windows CE .NET 4.0 and later.
Header: Windows.h.

See Also

EnumPropsEx | RemoveProp | SetProp

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.