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

Статья
11/20/2024

Определяемая приложением функция обратного вызова, используемая с функцией 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 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)