Classe WMI du serveur SMS_StatusMessage
La SMS_StatusMessage classe WMI (Windows Management Instrumentation) est une classe de serveur du fournisseur SMS, dans Configuration Manager, qui représente des messages d’état individuels générés par Configuration Manager pour fournir des informations sur divers événements, y compris l’achèvement du processus, les erreurs, les conditions et les actions de l’utilisateur.
La syntaxe suivante est simplifiée à partir du code MOF (Managed Object Format) et inclut toutes les propriétés héritées.
Syntaxe
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;
};
Méthodes
Le tableau suivant répertorie les méthodes dans SMS_StatusMessage.
| Méthode | Description |
|---|---|
| Méthode DeleteByID dans le SMS_StatusMessage de classe | Supprime un groupe de 256 messages d’état maximum. |
| Méthode DeleteByQuery dans la SMS_StatusMessage de classe | Supprime un groupe de messages d’état spécifié par une instruction SELECT du langage de requête WMI. |
| Méthode RaiseErrorStatusMsg dans la classe SMS_StatusMessage | Crée un message d’état d’erreur. |
| Méthode RaiseInformationalStatusMsg dans la classe SMS_StatusMessage | Crée un message d’état d’information. |
| Méthode RaiseRawStatusMsg dans la classe SMS_StatusMessage | Crée un message d’état à partir d’une DLL de message externe. |
| Méthode RaiseWarningStatusMsg dans la classe SMS_StatusMessage | Crée un message d’état d’avertissement. |
Propriétés
Component
Type de donnéesString
Type d’accès : Lecture
Qualificateurs : Aucun
Nom du composant qui a créé le message. Pour les messages définis par l’utilisateur, ce nom provient du ApplicationName qualificateur de contexte que vous devez définir avant d’appeler une méthode de message d’état d’augmentation.
MachineName
Type de donnéesString
Type d’accès : Lecture
Qualificateurs : Aucun
Nom de l’ordinateur qui a créé le message. Pour les messages définis par l’utilisateur, ce nom provient du MachineName qualificateur de contexte que vous devez définir avant d’appeler une méthode de message d’état d’augmentation.
MessageID
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : [Range(« 0-65535 »)]
ID unique du texte d’un message dans une DLL de message. Cette propriété est définie sur la valeur associée lorsque votre application appelle une méthode répertoriée dans le tableau suivant.
MessageType
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : Aucun
Type de message. Les valeurs possibles sont les suivantes :
| Valeur | Type de message |
|---|---|
| 256 | Étape. Utilisez ce type à la fin d’une opération pour indiquer la réussite ou l’échec de l’opération. Si l’opération a réussi, utilisez le type Jalon dans un message d’information. Si l’opération a échoué, utilisez un type de message jalon dans un message d’avertissement ou d’erreur. |
| 512 | Détail. Utilisez ce type pour illustrer les étapes d’une opération complexe. Souvent, les messages détaillés sont significatifs uniquement dans le contexte de la séquence de messages d’état représentant une opération complexe. |
| 768 | Audit. Utilisez ce type pour les messages d’information qui fournissent une trace des actions effectuées par l’administrateur Configuration Manager. Un message d’audit représente également une opération qui entraîne l’ajout, la modification ou la suppression d’objets. Vous n’avez pas besoin de créer des messages d’audit ; le fournisseur génère automatiquement ces messages pour vous. |
| 1024 | NTEvent. |
ModuleName
Type de donnéesString
Type d’accès : Lecture
Qualificateurs : Aucun
DLL associée au message d’état. Il ne s’agit pas du nom de la DLL proprement dite, mais d’une chaîne d’affichage correspondant à la ModuleName valeur de propriété définie dans la classe WMI SMS_StatMsgModuleNames Server . Vous utilisez la ModuleName valeur pour obtenir le nom de la DLL.
PerClient
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : Aucun
Valeur indiquant si le message d’état a été généré par un composant client. Les valeurs possibles sont répertoriées ci-dessous. Les messages générés par client ont tendance à être assez nombreux. Par conséquent, cette propriété offre un moyen simple de les filtrer.
| Valeur | Message généré par client |
|---|---|
| 0 | false |
| 2 | true |
ProcessID
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : Aucun
ID du processus qui a créé le message.
RecordID
Type de donnéesSInt64
Type d’accès : Lecture
Qualificateurs : [key]
ID unique du message d’état.
ReportFunction
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : Aucun
Fonction de rapport. Les valeurs possibles sont les suivantes :
| Valeur | Fonction de rapport |
|---|---|
| 0 | Rapport |
| 16 | BeginTransaction |
| 32 | CommitSuccessfulTransaction |
| 48 | CommitFailedTransaction |
| 64 | RollbackTransaction |
| 80 | ReportEX |
Severity
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : Aucun
Gravité du message d’état. Les valeurs possibles sont les suivantes :
| Valeur | Severity |
|---|---|
| 0x40000000 (1073741824) | Informatif |
| 0x80000000 (2147483648) | Avertissement |
| 0xC0000000 (3221225472) |
Error |
SiteCode
Type de donnéesString
Type d’accès : Lecture
Qualificateurs : [SizeLimit(« 3 »)]
Code de site du site qui a créé le message.
SuccessfulTransaction
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : Aucun
Valeur indiquant l’état de la transaction. Les valeurs possibles sont les suivantes :
| Valeur | État de la transaction |
|---|---|
| 0 | Échec |
| 8 | Réussi |
ThreadID
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : Aucun
Identificateur du thread qui a créé le message.
Time
Type de donnéesDateTime
Type d’accès : Lecture
Qualificateurs : Aucun
Date et heure, en temps universel coordonné (UTC), date et heure de création du message d’état.
TopLevelSiteCode
Type de donnéesString
Type d’accès : Lecture
Qualificateurs : [SizeLimit(« 3 »)]
Cette propriété est déconseillée.
Transaction
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : Aucun
Valeur indiquant si les transactions sont activées. Les valeurs possibles sont les suivantes :
| Valeur | Transaction activée |
|---|---|
| 0 | Faux |
| 4 | Vrai |
Win32Error
Type de donnéesUInt32
Type d’accès : Lecture
Qualificateurs : Aucun
Code d’erreur Win32 associé au message d’état.
Remarques
Les qualificateurs de classe pour cette classe sont les suivants :
Lecture (lecture seule)
Sécurisé
Pour plus d’informations sur les qualificateurs de classe et les qualificateurs de propriété inclus dans la section Propriétés, consultez Configuration Manager Qualificateurs de classe et de propriété.
Vous pouvez cette classe pour générer des messages d’état définis par l’utilisateur.
Remarque
Utilisez la classe WMI SMS_StatMsg Server pour une version hautes performances de cette classe.
Configuration requise
Configuration requise pour l’exécution
Pour plus d’informations, consultez Configuration Manager Server Runtime Requirements.
Conditions requises pour le développement
Pour plus d’informations, consultez Configuration Manager Server Development Requirements.