Функция обратного вызова PROPENUMPROCEXA (winuser.h)

Статья
08/27/2023

Определяемая приложением функция обратного вызова, используемая с функцией EnumPropsEx . Функция получает записи свойств из списка свойств окна. Тип PROPENUMPROCEX определяет указатель на эту функцию обратного вызова. PropEnumProcEx — это заполнитель для имени определяемой приложением функции.

Синтаксис

PROPENUMPROCEXA Propenumprocexa;

BOOL Propenumprocexa(
  HWND unnamedParam1,
  LPSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

Параметры

unnamedParam1

Тип: HWND

Дескриптор для окна, список свойств которого перечисляется.

unnamedParam2

Тип: LPTSTR

Строковый компонент записи списка свойств. Это строка, указанная вместе с дескриптором данных при добавлении свойства в список свойств окна с помощью вызова функции SetProp .

unnamedParam3

Тип: HANDLE

Дескриптор данных. Этот дескриптор является компонентом данных записи списка свойств.

unnamedParam4

Тип: ULONG_PTR

Данные, определяемые приложением. Это значение, указанное в качестве параметра lParam вызова EnumPropsEx , который инициировал перечисление.

Возвращаемое значение

Тип: BOOL

Возвращает значение TRUE , чтобы продолжить перечисление списка свойств.

Возвращает значение FALSE , чтобы остановить перечисление списка свойств.

Функция обратного вызова может вызывать функцию RemoveProp . Однако RemoveProp может удалить только свойство, переданное функции обратного вызова через параметры функции обратного вызова.
Функция обратного вызова не должна пытаться добавить свойства.

Примечание

Заголовок winuser.h определяет PROPENUMPROCEX в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)