將操作訊息傳送給用戶端。
語法
MI_INLINE MI_Result MI_INLINE_CALL MI_Context_WriteMessage(
[in] MI_Context *context,
MI_Uint32 channel,
const MI_Char *message
);
參數
[in] context
要求內容。
channel
要寫入的通道。 用戶端可以從下列其中一個通道中選取:
MI_WRITEMESSAGE_CHANNEL_WARNING (0)
用來廣播警告訊息的通道。
MI_WRITEMESSAGE_CHANNEL_VERBOSE (1)
用來廣播詳細資訊資訊訊息的通道。
MI_WRITEMESSAGE_CHANNEL_DEBUG (2)
用來廣播偵錯資訊的通道。
message
Null 終止的字串,表示要傳送至用戶端的訊息。 如果訊息是警告或詳細資訊,則訊息應當地語系化。
傳回值
指定函式傳回碼 之MI_Result 列舉的值。 這可以是下列其中一個程式碼。
備註
當需要傳送操作訊息給用戶端時,提供者會呼叫此函式。 作業訊息的範例是通知用戶端,因為長時間執行的刪除程式中已刪除哪些檔案,讓用戶端可以更新 UI。 請小心不要過度使用此函式,因為它可能會讓提供者的進度變慢。 用戶端可以選擇性地註冊以透過非同步回呼接收這些訊息。 如果用戶端未註冊這些訊息,伺服器將會忽略訊息。
需求
| 最低支援的用戶端 | Windows 8 |
| 最低支援的伺服器 | Windows Server 2012 |
| 目標平台 | Windows |
| 標頭 | mi.h |
| 可轉散發套件 | 在 Windows Server 2008 R2 上Windows Management Framework 3.0 SP1、Windows 7 SP1 和 Windows Server 2008 SP2 |