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

Статья
03/04/2024

[Эта функция не предназначена для общего использования. Он может быть изменен или недоступен в последующих версиях Windows.]

Копирует текст строки заголовка указанного окна (если она имеется) в буфер.

Эта функция аналогична функции GetWindowText . Однако он получает текст окна непосредственно из структуры окна, связанной с дескриптором указанного окна, а затем всегда предоставляет текст в виде строки Юникода. Это отличается от GetWindowText , который получает текст, отправляя в окно WM_GETTEXT сообщение. Если указанное окно является элементом управления , то получается текст элемента управления .

Синтаксис

int InternalGetWindowText(
  [in]  HWND   hWnd,
  [out] LPWSTR pString,
  [in]  int    cchMaxCount
);

Параметры

[in] hWnd

Тип: HWND

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

[out] pString

Тип: LPWSTR

Буфер, который будет принимать текст.

Если строка длинна или длиннее буфера, строка усекается и завершается символом NULL.

[in] cchMaxCount

Тип: int

Максимальное число символов, копируемых в буфер, включая символ NULL. Если текст превышает это ограничение, он усекается.

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

Тип: int

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

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

Эта функция не была включена в заголовки и библиотеки пакета SDK до Windows XP с пакетом обновления 1 (SP1) и Windows Server 2003. Если у вас нет файла заголовка и библиотеки импорта для этой функции, можно вызвать функцию с помощью LoadLibrary и GetProcAddress.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll