__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 |