SendMessageTimeout

הפונקציה SendMessageTimeout שולח את ההודעה שצוין של החלון או החלונות. הפונקציה קורא את ההליך החלון עבור חלון שצוין, אם החלון שצוין שייך משנה אחר, אינו חוזר עד בהליך חלון עיבד את ההודעה או פרק הזמן הקצוב שצוין כבר חלף. אם חלון קבלת ההודעה שייך אותו התור של הליך המשנה הנוכחי, ההליך חלון נקראת ישירות — ערך הזמן הקצוב מתעלמת.

 (LRESULT SendMessageTimeout HWND  hWnd, / / לטפל של חלון היעדUINTMsg, / / הודעה לשלוחWPARAMwParam, / / תחילה הודעה פרמטרLPARAMlParam, / / שניה פרמטר הודעהUINTfuFlags, / / כיצד לשלוח את ההודעהUINTuTimeout, / / משך הזמן הקצובLPDWORDlpdwResult / / החזרת הערך עבור הקריאה הסינכרוני);
 

פרמטרים

hWnd

לטפל לחלון הליך חלון אשר יקבלו את ההודעה. אם פרמטר זה הוא HWND_BROADCAST, ההודעה נשלחת אל כל חלונות ברמה במערכת, לרבות windows ללא בעלות מוגבלויות או בלתי נראים.

Msg

מציין את ההודעה תישלח.

wParam

ציון מידע ספציפי הודעה נוספת.

lParam

ציון מידע ספציפי הודעה נוספת.

fuFlags

מציין כיצד לשלוח את ההודעה. פרמטר זה יכול להיות שילוב של הערכים הבאים:

ערך	משמעות
SMTO_ABORTIFHUNG	החזרה מבלי להמתין פרק הזמן הקצוב שיעברו אם התהליך המקבל נראה במצב "תקוע".
SMTO_BLOCK	מונע את רצף הקריאה עיבוד בקשות נוספות עד הפונקציה מחזירה.
SMTO_NORMAL	הליך המשנה הקורא לא תימנע עיבוד בקשות אחרות בעת המתנה עבור הפונקציה לחזור.
SMTO_NOTIMEOUTIFNOTHUNG	Windows NT 5.0 ואילך: אינו חוזר כאשר מסתיים פרק הזמן הקצוב אם הליך משנה המקבל לא תלו.

uTimeout

ציון משך הזמן, באלפיות שניה, פרק הזמן הקצוב. אם ההודעה היא הודעת שידור, בכל חלון ניתן לנו פרק הזמן הקצוב מלא. לדוגמה, אם אתה מציין פרק זמן קצוב של 5 שניות, ישנם שלושה חלונות ברמה שלא להיכשל כדי לעבד את ההודעה, אתה יכול להכיל עד עיכוב השני 15.

lpdwResult

מציין את התוצאה של עיבוד ההודעה ותלוי להודעה שנשלחה.

להחזיר ערכים

אם הפונקציה מצליחה, הערך המוחזר אינו אפס.

אם הפעולה תיכשל או פסק זמן, הערך המוחזר הוא אפס. כדי לקבל מידע שגיאות מורחב, לקרוא GetLastError. אם GetLastError מחזירה אפס, אזי הפונקציה תם. SendMessageTimeout אינו מספק מידע אודות windows בודדים שתם הזמן הקצוב, אם נעשה שימוש HWND_BROADCAST.

QuickInfo

nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:לא נתמך.
כותרת עליונה:להצהיר על winuser.h.
ייבוא ספריית:השתמש user32.lib.
Unicode:מיושם על גירסאות Unicode ו- ANSI ב- Windows NT.

ראה גם

הודעות ודיוקן תורי הודעות, SendMessage, SendMessageCallback, של ההודעה ופונקציות תור הודעות, InSendMessage, PostMessage, SendDlgItemMessage, SendNotifyMessage

Index