__ExtendedStatus class

Article
06/13/2023

La classe système __ExtendedStatus est utilisée pour signaler des informations détaillées sur les status et les erreurs.

La syntaxe suivante est simplifiée à partir de code au format MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.

Syntaxe

class __ExtendedStatus : __NotifyStatus
{
  string Description;
  string Operation;
  string ParameterInfo;
  string ProviderName;
  uint32 StatusCode;
};

Membres

La classe __SystemEvent comprend les types de membres suivants :

Propriétés

Propriétés

La classe __ExtendedStatus a ces propriétés.

Description

Type de données : chaîne
Type d'accès : Lecture seule

Toute chaîne définie par l’utilisateur qui décrit une erreur ou un état opérationnel.

opération

Type de données : chaîne
Type d'accès : Lecture seule

Opération qui a lieu au moment d’une défaillance ou d’une anomalie. En règle générale, Windows Management Instrumentation (WMI) définit cette propriété sur le nom d’une méthode d’API COM pour WMI telle que la suivante : IWbemServices::CreateInstanceEnum.

ParameterInfo

Type de données : chaîne
Type d'accès : Lecture seule

Paramètres impliqués dans une erreur ou un changement d’état. Par exemple, si une application tente de récupérer une classe qui n’existe pas, cette propriété est définie sur le nom de classe incriminé.

ProviderName

Type de données : chaîne
Type d'accès : Lecture seule

Identifie le fournisseur qui provoque ou signale une erreur ou un changement d’état. Si aucun fournisseur n’est impliqué, cette chaîne est définie sur « Windows Management ».

StatusCode

Type de données : uint32
Type d'accès : Lecture seule

Contient une erreur ou un code d’informations pour une opération. Il peut s’agir de n’importe quelle valeur définie par le fournisseur, mais la valeur 0 (zéro) est généralement réservée pour indiquer la réussite. Cette propriété est héritée de __NotifyStatus.

Notes

La classe __ExtendedStatus est dérivée de la classe __NotifyStatus .

Utilisez la classe __ExtendedStatus pour signaler des informations plus complexes qu’un simple code de résultat. Les fournisseurs peuvent dériver leurs propres classes de __ExtendedStatus s’ils ont besoin de propriétés supplémentaires pour décrire les erreurs.

La propriété StatusCode, héritée de la classe parente __NotifyStatus, est un entier non signé qui représente l’erreur ou status valeur. Lorsque des instances de cette classe sont retournées à partir d’une méthode par un fournisseur dynamique, les propriétés StatusCode et Description sont définies par le fournisseur, et les autres propriétés sont définies par WMI.

Exemples

L’exemple de code suivant, extrait de l’exemple de code FND:How to Handle Configuration Manager Asynchrone Errors by Using WMI VBScript sur TechNet Gallery, décrit l’utilisation de __ExtendedStatus pour récupérer des informations d’erreur.

Sub sink_OnCompleted(HResult, oErr, oCtx) 
    WScript.Echo "All collections returned" 
  
    if HResult <> 0 Then  
    ' Determine the type of error. 
        If oErr.Path_.Class = "__ExtendedStatus" Then 
            WScript.Echo "WMI Error: "& oErr.Description             
        ElseIf ExtendedStatus.Path_.Class = "SMS_ExtendedStatus" Then 
            WScript.Echo "Provider Error: "& oErr.Description 
            WScript.Echo "Code: " & oErr.ErrorCode 
        End If 
    End If     
    bdone = true 
End sub

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Tous les espaces de noms WMI

Voir aussi

__NotifyStatus
Classes système WMI

Partager via