Classe __ExtendedStatus

La classe di sistema __ExtendedStatus viene usata per segnalare informazioni dettagliate sullo stato e sugli errori.

La sintassi seguente è semplificata dal codice MOF (Managed Object Format) e include tutte le proprietà ereditate. Le proprietà sono elencate in ordine alfabetico, non in ordine MOF.

Sintassi

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

Membri

La classe __ExtendedStatus ha questi tipi di membri:

• Proprietà

Proprietà

La classe __ExtendedStatus ha queste proprietà.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Qualsiasi stringa definita dall'utente che descrive un errore o uno stato operativo.

Operazione

Tipo di dati: string

Tipo di accesso: sola lettura

Operazione eseguita al momento di un errore o di un'anomalia. In genere, Strumentazione gestione Windows (WMI) imposta questa proprietà sul nome di un'API COM per il metodo WMI, ad esempio: IWbemServices::CreateInstanceEnum.

Parameterinfo

Tipo di dati: string

Tipo di accesso: sola lettura

Parametri coinvolti in un errore o una modifica dello stato. Ad esempio, se un'applicazione tenta di recuperare una classe che non esiste, questa proprietà viene impostata sul nome della classe che causa l'errore.

ProviderName

Tipo di dati: string

Tipo di accesso: sola lettura

Identifica il provider che causa o segnala un errore o una modifica dello stato. Se un provider non è coinvolto, questa stringa viene impostata su "Gestione Windows".

StatusCode

Tipo di dati: uint32

Tipo di accesso: sola lettura

Contiene un codice informativo o di errore per un'operazione. Può trattarsi di qualsiasi valore definito dal provider, ma il valore 0 (zero) è in genere riservato per indicare l'esito positivo. Questa proprietà viene ereditata da __NotifyStatus.

Osservazioni:

La classe __ExtendedStatus deriva dalla classe __NotifyStatus .

Usare la classe __ExtendedStatus per segnalare informazioni più complesse rispetto a un semplice codice di risultato. I provider possono derivare le proprie classi da __ExtendedStatus se richiedono più proprietà per descrivere gli errori.

La proprietà StatusCode , ereditata dalla classe padre __NotifyStatus , è un intero senza segno che rappresenta il valore di errore o stato. Quando le istanze di questa classe vengono restituite da un metodo da un provider dinamico, le proprietà StatusCode e Description vengono impostate dal provider e le altre proprietà vengono impostate da WMI.

Esempi

Nell'esempio di codice VBScript seguente viene descritto l'uso di __ExtendedStatus per recuperare informazioni sull'errore.

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

Requisiti

Vedi anche

__NotifyStatus

Classi di sistema WMI