BroadcastSystemMessage

BroadcastSystemMessage функция отправляет сообщение указанным получателям. Получатели могут быть приложения, устанавливаемые драйверы, сетевые драйверы, Системные драйверы сетевых или любой комбинации этих компонентов системы.

длинные ( ) BroadcastSystemMessage DWORD  dwFlags,  LPDWORD  lpdwRecipients,  UINT  uiMessage,  WPARAM  wParam,  LPARAM  lParam);
 

Параметры

dwFlags
Вариант флаги. Может быть комбинацией следующих значений:
Значение Значение
BSF_FLUSHDISK Очистка диска после того, как каждый получатель обрабатывает сообщение.
BSF_FORCEIFHUNG Продолжать широковещательное сообщение, даже если время ожидания истекает или один из получателей висела..
BSF_IGNORECURRENTTASK Не отправлять сообщение windows, которые принадлежат к текущей задаче. Это позволяет приложению получать свои собственные сообщения.
BSF_NOHANG Принудительное зависший приложения для времени ожидания. Если один из получателей время ожидания, не продолжайте вещание сообщение.
BSF_NOTIMEOUTIFNOTHUNG Дождитесь ответа на сообщение, при условии, что получатель не зависла. Время ожидания.
BSF_POSTMESSAGE Разместить сообщение. Не следует использовать в сочетании с BSF_QUERY.
BSF_QUERY Отправить сообщение одному получателю в то время, отправлять последующих получателю только если текущему получателю возвращает TRUE.

lpdwRecipients
Указатель на переменную, которая содержит и получает информацию о получателях сообщения. Переменная может быть комбинацией следующих значений:
Значение Значение
BSM_ALLCOMPONENTS Вещания для всех компонентов системы.
BSM_ALLDESKTOPS Windows NT: Трансляция на всех настольных компьютерах. Требует привилегий SE_TCB_NAME.
BSM_APPLICATIONS Трансляции для приложений.
BSM_INSTALLABLEDRIVERS Windows 95: Вещание на устанавливаемые драйверы.
BSM_NETDRIVER Windows 95: Трансляция сетевых драйверов.
BSM_VXDS Windows 95: Вещания для всех драйверов устройств системного уровня.

Когда функция возвращает значение, эта переменная получает комбинация этих значений, определении адресатов, которые фактически получил сообщение.

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

uiMessage
Идентификатор системного сообщения.
wParam
32-разрядное значение сообщений.
lParam
32-разрядное значение сообщений.

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

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

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

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

Примечания

Если BSF_QUERY не указан, функция отправляет указанное сообщение всем получателям запрашиваемого, игнорируя значения, возвращаемые этим получателям.

QuickInfo

nbsp; Windows &NT: требует версии 4.0 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Используйте user32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор очереди сообщений и сообщений, сообщения и функции очереди сообщений

Index