SMS_StatusMessage服务器 WMI 类

项目
04/04/2023

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 中消息文本的唯一 ID。当应用程序调用下表中列出的方法时，此属性设置为关联的值。

值	邮件 ID
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 本身的名称，而是与 SMS_StatMsgModuleNames 服务器 WMI 类中定义的属性值对应的ModuleName显示字符串。使用 ModuleName 值获取 DLL 名称。

PerClient
数据类型UInt32

访问类型：读取

限定符：无

指示状态消息是否由客户端组件生成的值。下面列出了可能的值。基于每个客户端生成的消息往往相当多。因此，此属性提供了一种简单的方法来筛选它们。

值	每个客户端生成的消息
0	`false`
2	`true`

ProcessID
数据类型UInt32

访问类型：读取

限定符：无

创建消息的进程 ID。

RecordID
数据类型SInt64

访问类型：读取

限定符：[key]

状态消息的唯一 ID。

ReportFunction
数据类型UInt32

访问类型：读取

限定符：无

报表函数。可能的值是：

值	报表函数
0	报告
16	BeginTransaction
32	CommitSuccessfulTransaction
48	CommitFailedTransaction
64	RollbackTransaction
80	ReportEX

Severity
数据类型UInt32

访问类型：读取

限定符：无

状态消息的严重性。可能的值是：

值	Severity
0x40000000 (1073741824)	信息
0x80000000 (2147483648)	警告
0xC0000000 (3221225472)	Error

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 服务器 WMI 类用于此类的高性能版本。

要求

运行时要求

有关详细信息，请参阅Configuration Manager服务器运行时要求。

开发要求

有关详细信息，请参阅Configuration Manager服务器开发要求。

另请参阅

SMS_StatMsg 服务器 WMI 类

通过

SMS_StatusMessage服务器 WMI 类

语法

方法

属性

备注

要求

运行时要求

开发要求

另请参阅

反馈

其他资源