Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La SMS_StatusMessage classe WMI (Windows Management Instrumentation) est une classe de serveur fournisseur SMS, dans Configuration Manager, qui représente les messages de status individuels générés par le Configuration Manager pour fournir des informations sur divers événements, notamment 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 de SMS_StatusMessage.
| Méthode | Description |
|---|---|
| Méthode DeleteByID en classe SMS_StatusMessage | Supprime un groupe de 256 messages de status maximum. |
| Méthode DeleteByQuery en classe SMS_StatusMessage | Supprime un groupe de messages de status spécifiés par une instruction SELECT du langage de requête WMI. |
| Méthode RaiseErrorStatusMsg en classe SMS_StatusMessage | Crée un message de status d’erreur. |
| Méthode RaiseInformationalStatusMsg en classe SMS_StatusMessage | Crée un message de status d’information. |
| Méthode RaiseRawStatusMsg en classe SMS_StatusMessage | Crée un message de status à partir d’une DLL de message externe. |
| Méthode RaiseWarningStatusMsg en classe SMS_StatusMessage | Crée un message d’status d’avertissement. |
Propriétés
Component Type de données : String
Type d’accès : Lecture
Qualificatifs : 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’augmentation de status.
MachineName Type de données : String
Type d’accès : Lecture
Qualificatifs : 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’augmentation de status.
MessageID Type de données : UInt32
Type d’accès : Lecture
Qualificateurs : [Plage(« 0-65535 »)]
ID unique du texte de 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ées : UInt32
Type d’accès : Lecture
Qualificatifs : Aucun
Type de message. Les valeurs possibles sont les suivantes :
| Valeur | Type de message |
|---|---|
| 256 | Jalon. 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 de 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 n’ont de sens que dans le contexte de la séquence de messages de status 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 du Configuration Manager. Un message d’audit décrit é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ées : String
Type d’accès : Lecture
Qualificatifs : Aucun
DLL associée au message de status. Il ne s’agit pas du nom de la DLL elle-même, mais d’une chaîne d’affichage correspondant à la valeur de propriété ModuleName définie dans la classe SMS_StatMsgModuleNames Server WMI . Vous utilisez la ModuleName valeur pour obtenir le nom de la DLL.
PerClient Type de données : UInt32
Type d’accès : Lecture
Qualificatifs : Aucun
Valeur indiquant si le message de status a été généré par un composant client. Les valeurs possibles sont énumérées ci-dessous. Les messages générés par client ont tendance à être assez nombreux. Ainsi, cette propriété offre un moyen facile de les filtrer.
| Valeur | Message généré par client |
|---|---|
| 0 | false |
| 2 | true |
ProcessID Type de données : UInt32
Type d’accès : Lecture
Qualificatifs : Aucun
ID du processus qui a créé le message.
RecordID Type de données : SInt64
Type d’accès : Lecture
Qualificateurs : [clé]
ID unique du message de status.
ReportFunction Type de données : UInt32
Type d’accès : Lecture
Qualificatifs : Aucun
Fonction 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ées : UInt32
Type d’accès : Lecture
Qualificatifs : Aucun
Gravité du message de status. Les valeurs possibles sont les suivantes :
| Valeur | Severity |
|---|---|
| 0x40000000 (1073741824) | Informatif |
| 0x80000000 (2147483648) | Avertissement |
| 0xC0000000 (3221225472) |
Erreur |
SiteCode Type de données : String
Type d’accès : Lecture
Qualificateurs : [SizeLimit(« 3 »)]
Code de site du site qui a créé le message.
SuccessfulTransaction Type de données : UInt32
Type d’accès : Lecture
Qualificatifs : Aucun
Valeur indiquant le status de la transaction. Les valeurs possibles sont les suivantes :
| Valeur | Transaction status |
|---|---|
| 0 | Échec |
| 8 | Réussi |
ThreadID Type de données : UInt32
Type d’accès : Lecture
Qualificatifs : Aucun
Identificateur du thread qui a créé le message.
Time Type de données : DateTime
Type d’accès : Lecture
Qualificatifs : Aucun
Date et heure, en temps universel coordonné (UTC), de création du message de status.
TopLevelSiteCode Type de données : String
Type d’accès : Lecture
Qualificateurs : [SizeLimit(« 3 »)]
Cette propriété est déconseillée.
Transaction Type de données : UInt32
Type d’accès : Lecture
Qualificatifs : 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ées : UInt32
Type d’accès : Lecture
Qualificatifs : Aucun
Code d’erreur Win32 associé au message de status.
Remarques
Les qualificatifs de classe pour cette classe sont les suivants :
Lecture (lecture seule)
Sécurisé
Pour plus d’informations sur les qualificateurs de classe et de propriété inclus dans la section Propriétés, voir Qualificateurs de classe et de propriété du Configuration Manager.
Vous pouvez utiliser cette classe pour générer des messages de status 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 requise pour Configuration Manager Server Runtime.
Configuration requise pour le développement
Pour plus d’informations, consultez Configuration requise pour le développement du serveur Configuration Manager.