Функция GetPropA (winuser.h)

Статья
08/27/2023

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

Синтаксис

HANDLE GetPropA(
  [in] HWND   hWnd,
  [in] LPCSTR lpString
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор для окна, в списке свойств которого требуется выполнить поиск.

[in] lpString

Тип: LPCTSTR

Атом, идентифицирующий строку. Если этот параметр является атомом, он должен быть создан с помощью функции GlobalAddAtom . 16-разрядное значение atom должно быть помещено в слово нижнего порядка параметра lpString ; Слово высокого порядка должно быть равно нулю.

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

Тип: HANDLE

Если список свойств содержит строку, возвращаемое значение является связанным дескриптором данных. В противном случае возвращаемое значение равно NULL.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-0 (представлено в Windows 8)