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