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

Статья
03/04/2024

Извлекает 16-битовое значение (WORD) с указанным смещением в дополнительную память класса для класса окна, которому принадлежит указанное окно.

Примечание Эта функция является нерекомендуемой для любого использования, кроме nIndex, для GCW_ATOM. Функция предоставляется только для совместимости с 16-разрядными версиями Windows. Приложения должны использовать функцию GetClassLong или GetClassLongPtr .

Синтаксис

WORD GetClassWord(
  [in] HWND hWnd,
  [in] int  nIndex
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор для окна и, косвенно, класса, к которому принадлежит окно.

[in] nIndex

Тип: int

Отсчитываемое от нуля смещение в байтах извлекаемого значения. Допустимые значения находятся в диапазоне от нуля до количества байтов памяти класса минус два; Например, если вы указали 10 или более байтов дополнительной памяти класса, значение 8 будет индексом пятого 16-битового целого числа. Существует дополнительное допустимое значение, как показано в следующей таблице.

Значение	Значение
GCW_ATOM -32	Извлекает значение ATOM , однозначно определяющее класс окна. Это тот же атом, который возвращает функция RegisterClass или RegisterClassEx .

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

Тип: WORD

Если функция выполняется успешно, возвращаемым значением будет запрошенное 16-битовое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования

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