SMS_StatusMessage Windows Management Instrumentation (WMI) 類別是 Configuration Manager 中的 SMS 提供者伺服器類別,代表 Configuration Manager 所產生的個別狀態消息,以提供各種事件的相關信息,包括進程完成、錯誤、條件和用戶動作。
下列語法已從受控物件格式 (MOF) 程式代碼簡化,並包含所有繼承的屬性。
語法
Class SMS_StatusMessage : SMS_BaseClass
{
String Component;
String MachineName;
UInt32 MessageID;
UInt32 MessageType;
String ModuleName;
UInt32 PerClient;
UInt32 ProcessID;
SInt64 RecordID;
UInt32 ReportFunction;
UInt32 Severity;
String SiteCode;
UInt32 SuccessfulTransaction;
UInt32 ThreadID;
DateTime Time;
String TopLevelSiteCode;
UInt32 Transaction;
UInt32 Win32Error;
};
方法
下表列出 中 SMS_StatusMessage的方法。
| 方法 | 描述 |
|---|---|
| 類別SMS_StatusMessage中的DeleteByID方法 | 刪除最多 256 個狀態消息的群組。 |
| 類別SMS_StatusMessage中的DeleteByQuery方法 | 刪除 WMI 查詢語言 SELECT 語句所指定的狀態消息群組。 |
| 類別SMS_StatusMessage的 RaiseErrorStatusMsg 方法 | 建立錯誤狀態消息。 |
| 類別SMS_StatusMessage的 RaiseInformationalStatusMsg 方法 | 建立信息狀態消息。 |
| 類別SMS_StatusMessage的 RaiseRawStatusMsg 方法 | 從外部訊息 DLL 建立狀態消息。 |
| 類別SMS_StatusMessage的 RaiseWarningStatusMsg 方法 | 建立警告狀態消息。 |
屬性
Component 資料類型: String
存取類型:讀取
限定符:無
建立訊息的元件名稱。 針對使用者定義的訊息,此名稱來自 ApplicationName 您在呼叫引發狀態消息方法之前必須設定的內容限定符。
MachineName 資料類型: String
存取類型:讀取
限定符:無
建立訊息的計算機名稱。 針對使用者定義的訊息,此名稱來自 MachineName 您在呼叫引發狀態消息方法之前必須設定的內容限定符。
MessageID 資料類型: UInt32
存取類型:讀取
限定符:[範圍 (“0-65535”) ]
訊息 DLL 中消息正文的唯一標識碼。 當您的應用程式呼叫下表所列的方法時,這個屬性會設定為相關聯的值。
| 值 | 郵件識別碼 |
|---|---|
| 39997 | 類別SMS_StatusMessage的 RaiseInformationalStatusMsg 方法 |
| 39998 | 類別SMS_StatusMessage的 RaiseWarningStatusMsg 方法 |
| 39999 | 類別SMS_StatusMessage的 RaiseErrorStatusMsg 方法 |
MessageType 資料類型: UInt32
存取類型:讀取
限定符:無
訊息的類型。 可能的值為:
| 值 | 訊息類型 |
|---|---|
| 256 | 里程碑。 在作業結束時使用此類型,表示作業成功或失敗。 如果作業成功,請在資訊訊息中使用里程碑類型。 如果作業失敗,請在警告或錯誤訊息中使用里程碑訊息類型。 |
| 512 | 細節。 使用此類型來說明複雜作業中的步驟。 通常,詳細訊息只有在代表複雜作業的狀態消息序列內容中才有意義。 |
| 768 | 審計。 針對提供 Configuration Manager 系統管理員所採取動作線索的資訊訊息,請使用此類型。 稽核訊息也會描述導致新增、修改或刪除對象的作業。 您不需要建立稽核訊息;提供者會自動為您產生這些訊息。 |
| 1024 | NTEvent。 |
ModuleName 資料類型: String
存取類型:讀取
限定符:無
與狀態消息相關聯的 DLL。 這不是 DLL 本身的名稱,而是對應至 ModuleNameSMS_StatMsgModuleNames Server WMI 類別 類別中定義之屬性值的顯示字串。 您可以使用 值 ModuleName 來取得 DLL 名稱。
PerClient 資料類型: UInt32
存取類型:讀取
限定符:無
值,指出狀態消息是否由用戶端元件產生。 可能的值如下所示。 以每個客戶端為基礎產生的訊息通常相當多。 因此,這個屬性可讓您輕鬆地篩選掉它們。
| 值 | 每個客戶端產生的訊息 |
|---|---|
| 0 | false |
| 2 | true |
ProcessID 資料類型: UInt32
存取類型:讀取
限定符:無
建立訊息之進程的標識碼。
RecordID 資料類型: SInt64
存取類型:讀取
限定符:[金鑰]
狀態消息的唯一標識碼。
ReportFunction 資料類型: UInt32
存取類型:讀取
限定符:無
報表函式。 可能的值為:
| 值 | 報表函式 |
|---|---|
| 0 | 報告 |
| 16 | BeginTransaction |
| 32 | CommitSuccessfulTransaction |
| 48 | CommitFailedTransaction |
| 64 | RollbackTransaction |
| 80 | ReportEX |
Severity 資料類型: UInt32
存取類型:讀取
限定符:無
狀態消息的嚴重性。 可能的值為:
| 值 | 嚴重性 |
|---|---|
| 0x40000000 (1073741824) | 參考 |
| 0x80000000 (2147483648) | 警告 |
| 0xC0000000 (3221225472) |
錯誤 |
SiteCode 資料類型: String
存取類型:讀取
限定符:[SizeLimit (“3”) ]
建立訊息之網站的月臺碼。
SuccessfulTransaction 資料類型: UInt32
存取類型:讀取
限定符:無
指出交易狀態的值。 可能的值為:
| 值 | 交易狀態 |
|---|---|
| 0 | 失敗 |
| 8 | 成功 |
ThreadID 資料類型: UInt32
存取類型:讀取
限定符:無
建立訊息之線程的標識碼。
Time 資料類型: DateTime
存取類型:讀取
限定符:無
建立狀態消息的日期和時間,在通用協調時間 (UTC) 。
TopLevelSiteCode 資料類型: String
存取類型:讀取
限定符:[SizeLimit (“3”) ]
這個屬性已被取代。
Transaction 資料類型: UInt32
存取類型:讀取
限定符:無
指出是否已啟用交易的值。 可能的值為:
| 值 | 已啟用交易 |
|---|---|
| 0 | 錯 |
| 4 | True |
Win32Error 資料類型: UInt32
存取類型:讀取
限定符:無
與狀態消息相關聯的 Win32 錯誤碼。
註解
此類別的類別限定元包括:
唯讀 ()
安全的
如需 [屬性] 區段中包含之類別限定符和屬性限定符的詳細資訊,請參閱 Configuration Manager 類別和屬性限定符。
您可以使用此類別來產生使用者定義的狀態訊息。
注意事項
針對這個類別的高效能版本,請使用 SMS_StatMsg Server WMI 類別 。
需求
運行時間需求
如需詳細資訊,請參閱 Configuration Manager 伺服器運行時間需求。
開發需求
如需詳細資訊,請參閱 Configuration Manager 伺服器開發需求。