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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] hWnd

Тип: HWND

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

[in] lpString

Тип: LPCTSTR

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

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

Тип: HANDLE

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll
набор API	ext-ms-win-ntuser-window-l1-1-0 (представлено в Windows 8)