Функция SHSendMessageBroadcastA (shlwapi.h)

Статья
11/20/2024

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

Отправляет сообщение всем окнам верхнего уровня в системе.

Синтаксис

LRESULT SHSendMessageBroadcastA(
  [in] UINT   uMsg,
  [in] WPARAM wParam,
  [in] LPARAM lParam
);

Параметры

[in] uMsg

Тип: UINT

Сообщение для отправки.

[in] wParam

Тип: WPARAM

Дополнительные сведения о сообщении.

[in] lParam

Тип: LPARAM

Дополнительные сведения о сообщении.

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

Тип: LRESULT

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

Замечания

SHSendMessageBroadcast эквивалентен SendMessage с HWND_BROADCAST. Чтобы избежать того, чтобы оболочка не отвечала в случае, если в системе может быть окно, которое не отвечает на сообщения, используйте SHSendMessageBroadcast.

SHSendMessageBroadcast не экспортируется по имени. SHSendMessageBroadcastA экспортируется из Shlwapi.dll как порядковый номер 432. SHSendMessageBroadcastW экспортируется из Shlwapi.dll как порядковый номер 433.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlwapi.h
DLL	Shlwapi.dll (версия 5.0 или более поздняя версия)

Поделиться через