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

Статья
03/09/2024

Определяет новое сообщение окна, которое гарантированно будет уникальным во всей системе. Значение сообщения можно использовать при отправке или публикации сообщений.

Синтаксис

UINT RegisterWindowMessageA(
  [in] LPCSTR lpString
);

Параметры

[in] lpString

Тип: LPCTSTR

Регистрировать сообщение.

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

Тип: UINT

Если сообщение успешно зарегистрировано, возвращаемое значение будет идентификатором сообщения в диапазоне 0xC000 по 0xFFFF.

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

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

Используйте RegisterWindowMessage, только если несколько приложений должны обработать одно и то же сообщение. Для отправки личных сообщений в классе окна приложение может использовать любое целое число в диапазоне WM_USER через 0x7FFF. (Сообщения в этом диапазоне являются закрытыми для класса окна, а не для приложения. Например, стандартные классы элементов управления, такие как BUTTON, EDIT, LISTBOX и COMBOBOX , могут использовать значения в этом диапазоне.)

Примеры

Пример см. в разделе Поиск текста.

Примечание

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

Требования

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