IConsole：：MessageBox 方法 (mmc.h)
顯示訊息方塊。
語法
HRESULT MessageBox(
[in] LPCWSTR lpszText,
[in] LPCWSTR lpszTitle,
[in] UINT fuStyle,
[out] int *piRetval
);
參數
[in] lpszText
包含要顯示之訊息之 Null 終止字串的指標。
[in] lpszTitle
用於消息框標題之 Null 終止字串的指標。 如果此參數為 NULL，則會使用預設標題 「Error」。
[in] fuStyle
值，指定決定消息框內容和行為的一組位旗標。 此參數可以是來自下列旗標群組的旗標組合，這些旗標取自 Windows API MessageBox 的檔。
指定下列其中一個旗標，以指出哪些按鈕會出現在消息框中。
MB_ABORTRETRYIGNORE
消息框包含三個按鈕：中止、重試和忽略。
MB_OK
消息框包含一個按鈕：[確定]。 此為預設值。
MB_OKCANCEL
消息框包含兩個按鈕：[確定] 和 [取消]。
MB_RETRYCANCEL
消息框包含兩個按鈕：重試和取消。
MB_YESNO
消息框包含兩個按鈕：[是] 和 [否]。
MB_YESNOCANCEL
消息框包含三個按鈕：[是]、[否] 和 [取消]。
指定下列其中一個旗標，以指出消息框中出現的圖示：
MB_ICONEXCLAMATION，MB_ICONWARNING
消息框中會出現驚嘆號圖示。
MB_ICONINFORMATION，MB_ICONASTERISK
由圓形中的 「I」 所組成的圖示會出現在消息框中。
MB_ICONQUESTION
消息框中會出現問號圖示。
MB_ICONSTOP，
MB_ICONERROR，MB_ICONHAND
消息框中會出現停止符號圖示。
指定下列其中一個旗標來指出預設按鈕：
MB_DEFBUTTON1
除非此群組中的其中一個其他旗標指定為預設值，否則第一個按鈕是預設按鈕。
MB_DEFBUTTON2
第二個按鈕是預設按鈕。
MB_DEFBUTTON3
第三個按鈕是預設按鈕。
MB_DEFBUTTON4
第四個按鈕是預設按鈕。
指定下列其中一個旗標，以指出對話框的型態：
MB_APPLMODAL
用戶必須先回應消息框，才能繼續在目前窗口中運作。 不過，使用者可以移至其他應用程式的視窗，並在這些視窗中工作。 如果未指定MB_SYSTEMMODAL或MB_TASKMODAL，則預設值為 MB_APPLMODAL。
MB_SYSTEMMODAL
所有應用程式都會暫停，直到用戶回應消息框為止。 系統強制回應消息框可用來通知用戶嚴重、可能有害的錯誤，這些錯誤需要立即注意，而且應該謹慎使用。
MB_TASKMODAL
類似於 MB_APPLMODAL，但在 Microsoft Foundation Classes (MFC) 應用程式中並不實用。 此旗標保留給沒有視窗句柄的呼叫應用程式或連結庫。
此外，您可以指定下列旗標：
MB_DEFAULT_DESKTOP_ONLY
目前接收輸入的桌面必須是默認桌面;否則，函式會失敗。 默認桌面是在使用者登入之後執行的應用程式。
MB_HELP
將 [說明 ] 按鈕新增至消息框。 選擇 [ 說明 ] 按鈕或按 F1 會產生 [說明] 事件。
MB_RIGHT
文字靠右對齊。
MB_RTLREADING
使用希伯來文和阿拉伯文系統的由右至左閱讀順序顯示訊息和 標題 文字。
MB_SETFOREGROUND
消息框會變成前景視窗。 在內部，操作系統會呼叫消息框的 SetForegroundWindow 函式。
MB_TOPMOST
消息框會以 窗口樣式WS_EX_TOPMOST 建立。
MB_SERVICE_NOTIFICATION
呼叫者是一個會通知使用者發生事件的服務。 函式會顯示目前使用中桌面上的消息框，即使沒有使用者登入計算機也一樣。
如需使用此旗標的詳細資訊，請參閱 MessageBox 函式。
MB_SERVICE_NOTIFICATION_NT3x
這個值會對應至針對舊版 Windows MB_SERVICE_NOTIFICATION 定義的值。
[out] piRetval
傳回值的指標。
傳回值
這個方法可以傳回下列其中一個值。
備註
MessageBox 不應該用於顯示嵌入式管理單元沒有焦點時所發生的錯誤。 一般
只有當錯誤要求使用者注意時，以及結果窗格包含有用的資訊時，才應該使用 MessageBox。
在大部分情況下，MMC 訊息 OCX 控件是顯示錯誤訊息的更適當方式。 如需詳細資訊，請參閱 使用 MMC 訊息 OCX 控制件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | mmc.h |
| Dll | Mmcndmgr.dll |