Функция RegisterWindowMessageA (winuser.h)
Определяет новое сообщение окна, которое гарантированно будет уникальным во всей системе. Значение сообщения можно использовать при отправке или публикации сообщений.
Синтаксис
UINT RegisterWindowMessageA(
[in] LPCSTR lpString
);
Параметры
[in] lpString
Тип: LPCTSTR
Зарегистрированное сообщение.
Возвращаемое значение
Тип: UINT
Если сообщение успешно зарегистрировано, возвращаемое значение является идентификатором сообщения в диапазоне 0xC000 через 0xFFFF.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Функция RegisterWindowMessage обычно используется для регистрации сообщений для обмена сообщениями между двумя приложениями.
Если два разных приложения регистрируют одну и ту же строку сообщения, приложения возвращают одно и то же значение сообщения. Сообщение остается зарегистрированным до окончания сеанса.
Используйте только RegisterWindowMessage, если несколько приложений должны обрабатывать одно и то же сообщение. Для отправки частных сообщений в классе окон приложение может использовать любое целое число в диапазоне WM_USER через 0x7FFF. (Сообщения в этом диапазоне являются частными для класса окон, а не для приложения. Например, стандартные классы элементов управления, такие как BUTTON, EDIT, LISTBOXи COMBOBOX могут использовать значения в этом диапазоне.)
Примеры
Пример см. в разделе поиск текста.
Заметка
Заголовок winuser.h определяет RegisterWindowMessage в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | winuser.h (включая Windows.h) |
| библиотеки |
User32.lib |
| DLL | User32.dll |
| набор API | ext-ms-win-ntuser-message-l1-1-0 (представлено в Windows 8) |
См. также
концептуальные
сообщений и очередей сообщений
Справочник