MI_CoNtext_WriteMessage函式 (mi.h)

將操作訊息傳送給用戶端。

語法

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

另請參閱

MI_CoNtext