__ExtendedStatus-Klasse

Die " _ _ ExtendedStatus "-System Klasse wird verwendet, um detaillierte Status-und Fehlerinformationen zu melden.

Die folgende Syntax wird durch MOF-Code (Managed Object Format) vereinfacht und schließt alle geerbten Eigenschaften ein. Eigenschaften werden in alphabetischer Reihenfolge und nicht in der MOF-Reihenfolge aufgelistet.

Syntax

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

Member

Die _ _ ExtendedStatus -Klasse verfügt über diese Typen von Membern:

Eigenschaften

Die _ _ ExtendedStatus -Klasse verfügt über diese Eigenschaften.

Beschreibung

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Eine beliebige benutzerdefinierte Zeichenfolge, die einen Fehler-oder Betriebsstatus beschreibt.

Vorgang

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Der Vorgang, der zum Zeitpunkt eines Fehlers oder einer Anomalieerkennung stattfindet. In der Regel legt Windows-Verwaltungsinstrumentation (WMI) diese Eigenschaft auf den Namen einer com-API für die WMI-Methode fest, z. b. die folgende: IWbemServices:: kreateinstanceenum.

Parameter Info

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Parameter, die an einem Fehler oder einer Statusänderung beteiligt sind. Wenn eine Anwendung z. b. versucht, eine Klasse abzurufen, die nicht vorhanden ist, wird diese Eigenschaft auf den Namen der angreifenden Klasse festgelegt.

ProviderName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Identifiziert den Anbieter, der einen Fehler oder eine Statusänderung auslöst oder meldet. Wenn ein Anbieter nicht beteiligt ist, wird diese Zeichenfolge auf "Windows-Verwaltung" festgelegt.

Statuscode

Datentyp: UInt32

Zugriffstyp: Schreibgeschützt

Enthält einen Fehler-oder Informations Code für einen Vorgang. Dies kann ein beliebiger Wert sein, der vom Anbieter definiert wird. der Wert 0 (null) ist jedoch normalerweise reserviert, um den Erfolg anzugeben. Diese Eigenschaft wird von _ _ notifystatusgeerbt.

Bemerkungen

Die _ _ ExtendedStatus -Klasse wird von der _ _ notifystatus -Klasse abgeleitet.

Verwenden Sie die _ _ ExtendedStatus -Klasse, um Informationen zu melden, die komplexer sind als ein einfacher Ergebniscode. Anbieter können Ihre eigenen Klassen von _ _ ExtendedStatus ableiten, wenn Sie weitere Eigenschaften benötigen, um die Fehler zu beschreiben.

Die Statuscode -Eigenschaft, die von der übergeordneten _ _ notifystatus -Klasse geerbt wurde, ist eine Ganzzahl ohne Vorzeichen, die den Fehler-oder Statuswert darstellt. Wenn Instanzen dieser Klasse von einem dynamischen Anbieter von einer Methode zurückgegeben werden, werden die Eigenschaften " Statuscode " und " Beschreibung " vom Anbieter festgelegt, und die anderen Eigenschaften werden von WMI festgelegt.

Beispiele

Das folgende Codebeispiel stammt aus dem FND: Behandeln von Configuration Manager asynchronen Fehlern mithilfe von WMI VBScript-Codebeispiel in der TechNet Gallery, beschreibt die Verwendung von _ _ ExtendedStatus zum Abrufen von Fehlerinformationen.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Namespace
Alle WMI-Namespaces

Siehe auch

__Notifystatus

WMI-System Klassen