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