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 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.

ראה גם

הודעות ודיוקן תורי הודעות, הודעה ופונקציות תור הודעות

Index