__ExtendedStatus-Klasse
Die Systemklasse __ExtendedStatus 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 aufgeführt, nicht in MOF-Reihenfolge.
Syntax
class __ExtendedStatus : __NotifyStatus
{
string Description;
string Operation;
string ParameterInfo;
string ProviderName;
uint32 StatusCode;
};
Member
Die Klasse __ExtendedStatus verfügt über die folgenden Member-Klassen:
Eigenschaften
Die __ExtendedStatus-Klasse verfügt über die folgenden Eigenschaften.
-
Beschreibung
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Jede benutzerdefinierte Zeichenfolge, die einen Fehler oder einen operativen Status beschreibt.
-
-
Vorgang
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Vorgang, der zum Zeitpunkt eines Fehlers oder einer Anomalie stattfindet. In der Regel legt die Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) diese Eigenschaft auf den Namen einer COM-API für die WMI-Methode fest, z. B. IWbemServices::CreateInstanceEnum.
-
-
ParameterInfo
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Parameter, die an einem Fehler oder einer Statusänderung beteiligt sind. Wenn beispielsweise eine Anwendung versucht, eine Klasse abzurufen, die nicht vorhanden ist, wird diese Eigenschaft auf den Namen der Klasse festgelegt, die den Fehler ausgelöst hat.
-
-
ProviderName
-
-
Datentyp: string
-
Zugriffstyp: Schreibgeschützt
Gibt den Anbieter an, der einen Fehler oder eine Statusänderung verursacht oder meldet. Wenn kein Anbieter beteiligt ist, wird diese Zeichenfolge auf „Windows-Verwaltung“ festgelegt.
-
-
StatusCode
-
-
Datentyp: uint32
-
Zugriffstyp: Schreibgeschützt
Enthält einen Fehler- oder Informationscode für einen Vorgang. Dies kann jeder vom Anbieter definierte Wert sein, aber der Wert 0 (Null) ist normalerweise zum Angeben eines erfolgreichen Vorgangs reserviert. Diese Eigenschaft wird von __NotifyStatus geerbt.
-
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 mehr Eigenschaften benötigen, um die Fehler zu beschreiben.
Die StatusCode-Eigenschaft, geerbt von der übergeordneten Klasse __NotifyStatus, ist eine ganze Zahl 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 Description vom Anbieter festgelegt, und die anderen Eigenschaften werden von WMI festgelegt.
Beispiele
Das folgende Codebeispiel aus dem VBScript-Codebeispiel der TechNet Gallery Behandeln von asynchronen Fehlern in Configuration Manager mithilfe von WMI 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 |