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

Статья
11/20/2024

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

Синтаксис

int GetClassNameA(
  [in]  HWND  hWnd,
  [out] LPSTR lpClassName,
  [in]  int   nMaxCount
);

Параметры

[in] hWnd

Тип: HWND

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

[out] lpClassName

Тип: LPTSTR

Строка имени класса.

[in] nMaxCount

Тип: int

Длина буфера lpClassName в символах. Буфер должен быть достаточно большим, чтобы включить завершающий символ NULL; в противном случае строка имени класса усечена до nMaxCount-1 символов.

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

Тип: int

Если функция выполнена успешно, возвращаемое значение — это число символов, скопированных в буфер, не включая завершающийся символ NULL.

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

Замечания

Заметка

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

Требования

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